D
design-philosophy
Zasady projektowania kodu: zmniejsz złożoność, ujawniaj stopniowo, używaj typów
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill zawierający kluczowe zasady projektowania dla czystego, łatwego w utrzymaniu kodu. Zastosuj je przy projektowaniu API, modułów i struktur danych. Obejmuje cztery filary: minimalizacja obciążenia poznawczego, progresywne ujawnianie funkcji, uniemożliwianie nieprawidłowych stanów poprzez system typów oraz tworzenie abstrakcji, które faktycznie zmniejszają złożoność. Idealny dla deweloperów piszących lub recenzujących kod.
Jak używać
- Zainstaluj skill design-philosophy w swoim projekcie Claude, dodając go do konfiguracji umiejętności agenta.
- Kiedy projektując nowy API, moduł lub strukturę danych, aktywuj skill i przejrzyj cztery główne zasady: minimalizację obciążenia poznawczego, progresywne ujawnianie, reprezentowalność stanów poprzez typ oraz wartość abstrakcji.
- Podczas refaktoryzacji istniejącego kodu sprawdź, czy każdy moduł ma jedną, jasną odpowiedzialność i czy publiczne interfejsy są minimalne i intuicyjne.
- W procesie code review użyj skill do oceny, czy abstrakcje rzeczywiście zmniejszają złożoność, czy ją tylko przenoszą, oraz czy dokumentacja postępuje od ogólnego do szczegółowego.
- Konsultuj się ze skill'em, gdy rozważasz wprowadzenie nowej abstrakcji — upewnij się, że zrozumienie jej nie wymaga więcej wysiłku niż kod konkretny.
- Wykorzystaj wytyczne dotyczące systemu typów, aby przenieść walidację z czasu wykonania na czas kompilacji, unikając błędów na etapie projektowania.