C
clean-code
Pragmatyczne standardy kodowania – zwięźle, bez nadmiaru, bez zbędnych komentarzy
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill clean-code to zestaw pragmatycznych zasad kodowania dla AI. Uczy pisać kod prosty, czytelny i efektywny – bez over-engineeringu i zbędnych wyjaśnień. Obejmuje pięć kluczowych zasad: Single Responsibility, DRY, KISS, YAGNI i Boy Scout. Zawiera konkretne reguły nazewnictwa zmiennych, funkcji i stałych, standardy dla długości funkcji oraz wzorce strukturalne. Skill kieruje AI do pisania kodu bezpośrednio, naprawiania błędów bez zbędnych wyjaśnień i pytania, gdy wymogi są niejasne.
Jak używać
- Zainstaluj skill clean-code w swoim środowisku Claude, dodając go do konfiguracji dozwolonych narzędzi (Read, Write, Edit).
- Gdy prosisz AI o napisanie kodu, skill automatycznie stosuje pragmatyczne standardy – kod będzie zwięzły, bez zbędnych komentarzy i bez nadmiarowych funkcji.
- Jeśli zgłaszasz błąd w kodzie, skill kieruje AI do bezpośredniej naprawy zamiast długich wyjaśnień – skupienie na rozwiązaniu, nie na opisie problemu.
- Stosuj reguły nazewnictwa: zmienne powinny ujawniać intencję (userCount zamiast n), funkcje mają formę czasownik+rzeczownik (getUserById), zmienne logiczne pytające (isActive, hasPermission).
- Pamiętaj o pięciu kluczowych zasadach: każda funkcja robi JEDNĄ rzecz (SRP), nie powtarzaj kodu (DRY), wybieraj najprostsze rozwiązanie (KISS), nie buduj nieużywanych funkcji (YAGNI), zostawiaj kod czystszy niż go zastałeś (Boy Scout).
- Skill wspiera pracę z kodem poprzez guard clauses, płaską strukturę zamiast zagnieżdżeń i kompozycję małych funkcji – zawsze pytaj, jeśli wymogi są niejasne, zamiast zgadywać.