python-project-structure

Skill do projektowania dobrze zorganizowanych projektów Python z wyraźnymi granicami modułów i explicytnie zdefiniowanymi publicznymi interfejsami. Dowiesz się, jak strukturyzować katalogi, grupować powiązany kod w moduły, definiować publiczne API za pomocą all i utrzymać spójne konwencje nazewnictwa. Idealne do uruchamiania nowych projektów od zera, reorganizacji istniejącego kodu lub tworzenia bibliotek wielokrotnego użytku.

1. Zainstaluj skill w swoim środowisku agenta, dodając go do konfiguracji pluginów python-development.
2. 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.
3. 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.
4. 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.
5. 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.
6. Stosuj sugerowane konwencje nazewnictwa i organizacji konsekwentnie w całym projekcie, korzystając ze skilla jako punktu odniesienia dla nowych modułów.