P
python-project-structure
Python project organization, module architecture, and public API design. Use when setting up new projects, organizing modules, defining public interfaces with __all__, or planning directory layouts.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Python project organization, module architecture, and public API design. Use when setting up new projects, organizing modules, defining public interfaces with all, or planning directory layouts.
How to use
- Zainstaluj skill w swoim środowisku agenta, dodając go do konfiguracji pluginów python-development.
- Uruchom skill przy rozpoczynaniu nowego projektu Python, podając nazwę projektu i jego główny cel – otrzymasz rekomendowaną strukturę katalogów z podziałem na src/, tests/ i pliki konfiguracyjne.
- Dla istniejącego kodu użyj skilla do analizy bieżącej organizacji – wskaż katalog główny projektu, a skill zaproponuje refaktoryzację zgodnie z zasadą jednej koncepcji na plik.
- Zdefiniuj publiczne interfejsy modułów, pytając skilla o najlepsze praktyki dla all w każdym module – skill pokaże, które funkcje i klasy powinny być eksportowane.
- Przy decyzjach architektonicznych (struktura płaska vs zagnieżdżona, umiejscowienie testów) konsultuj się ze skillem, podając kontekst projektu – otrzymasz konkretne rekomendacje z uzasadnieniem.
- Stosuj sugerowane konwencje nazewnictwa i organizacji konsekwentnie w całym projekcie, korzystając ze skilla jako punktu odniesienia dla nowych modułów.