Developer · FREE

Plan krokowy do implementacji

Z zaakceptowanego specu tnie pracę na zadania 2-5 minut: dokładna ścieżka pliku, co ma powstać, jak sprawdzić. Junior albo agent idzie task po tasku bez zgadywania i bez 'reszta analogicznie'.

reviewed:

Jak zainstalować

  1. Uzupełnij pola poniżej (albo zostaw nazwy zmiennych i dopisz w czacie). Wartości z Skill creatora na liście podstawiają się same.
  2. Kopiuj, potem wklej w Claude.ai (instrukcje projektu) albo ChatGPT (Custom Instructions).
  3. Albo pobierz SKILL.md i połóż w folderze skilli Claude Code.
SKILL
Zaakceptowany spec albo lista zachowań: [SPEC]. Drzewo repo: [REPO]. Komenda testów: [TESTY].

NIE PISZ PRODUKCJI I NIE ODPALAJ IMPLEMENTACJI. To nie jest grill zakresu (grill-zadania = cel i poza zakresem; tu = kolejność plików). To nie jest ADR.

Jeśli [SPEC] pusty, ogólnik albo "jeszcze nie potwierdzony" - poproś o podpisany spec i stop.
Jeśli [TESTY] puste - zapytaj runner (pytest, vitest, go test...) i stop.

Najpierw mapa plików (tworzone / zmieniane / test), potem taski. Kolejność taka, by żaden task nie wymagał pliku z przyszłego taska.

Każdy task (numerowany) MA mieć, bez wyjątków:

1. Ścieżka pliku (dokładna, z katalogu repo). Zero "reszta analogicznie", zero "podobnie jak task N".
2. Opis zmiany w 1-2 zdaniach (co powstanie, nie "posprzątaj").
3. Failing test: nazwa + asercja + (krótki snippet). To ten test ma paść, zanim powstanie produkcja.
4. Komenda weryfikacji, która ma paść albo przejść (pełna, kopiowalna). Oczekiwany output: FAIL z jaką asercją / PASS.
5. Kryterium "done" tego taska (jedno zdanie, obserwowalne).

Granulacja kroku wewnątrz taska: 2-5 minut, jedna akcja. Typowy szkielet taska:

- napisz failing test
- odpal komendę, obejrzyj czerwień
- minimalna implementacja
- odpal komendę, zieleń
- commit (jedna myśl)

Zakazy w planie (to są błędy planu, nie "dopisz później"):

- TBD, TODO, "uzupełnij", "dodaj walidację", "obsłuż edge case"
- "napisz testy do powyższego" bez nazwy testu i komendy
- task, który rusza plik z przyszłego taska
- nowa biblioteka, cache, repozytorium "przy okazji"
- zmiana publicznego kontraktu, której nie ma w [SPEC]

Na końcu: luka vs spec (który punkt specu nie ma taska) albo "pokrycie pełne". Dwa zdania architektury, nie esej.

Stop. Pytanie: "plan przyjęty, iść task 1 (TDD)?" Dywiz "-". Kod w snippetach po angielsku.

Zanim wkleisz

Skill vs zły prompt

Zły prompt

Rozpisz implementację całości, analogicznie reszta, i od razu koduj.

Skill

Zaakceptowany spec albo lista zachowań: [SPEC]. Drzewo repo: [REPO]. Komenda testów: [TESTY].

NIE PISZ PRODUKCJI I NIE ODPALAJ IMPLEMENTACJI. To nie jest grill zakresu (grill-zadania = cel i poza zakresem; tu = kolejność plików). To nie jest ADR.

Jeśli [SPEC] pusty, ogólnik albo "jeszcze nie potwierdzony" - poproś o podpisany spec i stop.
Jeśli [TESTY] puste - zapytaj runner (pytest, vitest, go test...) i stop.

Najpierw mapa plików (tworzone / zmieniane / test), potem taski. Kolejność taka, by żaden task nie wymagał pliku z przyszłego taska.

Użyj z tym narzędziem

Lekcja: claude-start-06-claude-dla-programisty

Pytania

Jak użyć skilla "Plan krokowy do implementacji" w Claude?

Uzupełnij pola w nawiasach (albo weź je z profilu Skill creator na /skille), kliknij Kopiuj i wklej treść do instrukcji projektu w Claude.ai. W Claude Code kliknij Pobierz SKILL.md i połóż plik w folderze skilli. Skill działa też w ChatGPT (Custom Instructions). Nie chowa się za paywallem: kopia jest darmowa.

Kiedy tego skilla NIE używać?

Nie gdy zmiana to jedna linia w jednym pliku. Nie zastępuje ADR (to nie wybór architektury). Nie gdy spec nie jest podpisany.