Developer · FREE

Debug systematyczny (4 fazy)

Pętla odtwórz, zawęź warstwę, trzy hipotezy z testem każdej, jedna zmiana. Nie zgaduje z logu i nie pisze trzech fixów przy okazji.

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
Stack: [STACK]. Srodowisko: [SRODOWISKO]. Objaw (co czlowiek widzi): [OBJAW].

Repro / dowod (kroki, nie sciana logu):
[REPRO]

To NIE jest skill `debug-logi`. Tam: 3 hipotezy Z LOGU i stop. Tu pelna petla 4 faz. NIE PISZ PATCHA NA WEJSCIU.

Zwracasz, w tej kolejnosci:

## 1. Odtworz
- Kroki, ktore agent albo czlowiek powtarza 1:1.
- Wynik: DA SIE / NIE DA SIE.
- Jesli NIE DA SIE: to blocker. Wypisz czego brakuje (srodowisko, dane, flaga, 1 request). ZERO hipotez, ZERO kodu. Stop.

## 2. Zawęź warstwę
Jedna warstwa, z dowodem: klient / API / auth / DB / kolejka / cron / siec.
Komenda albo 1 klik, ktory odcina reszte. Nie "pewnie frontend".

## 3. Trzy hipotezy
Od najbardziej prawdopodobnej. Kazda:
- plik albo warstwa
- komenda falsyfikacji (exit != 0 = obalona)
- czego ta hipoteza NIE tlumaczy

Zakaz: "na pewno cache", "na pewno race", "na pewno env" bez komendy.

## 4. Jedna zmiana (dopiero po "ok, koduj")
- Minimalny diff w miejscu, gdzie dane wchodza, nie tylko tam gdzie widać objaw.
- Test, ktory na starym kodzie padalby.
- Czego NIE ruszać przy okazji (3 rzeczy).

Jesli w [REPRO] widzisz klucz, token, haslo, PESEL - przerwij, kaz wyciac, nie powtarzaj sekretu.
Jesli [OBJAW] albo [REPRO] puste - dopytaj o kroki odtworzenia i stop. Nie proś o dump logu "na wszelki wypadek".
Jesli objaw to jedna linijka typo z jasnym repro: napisz to w fazie 1-2, zaproponuj 1 patch i czekaj na "ok, koduj".
Dywiz "-". Kod po angielsku.

Zanim wkleisz

Skill vs zły prompt Użyj z tym narzędziem

Skill vs zły prompt

Zły prompt

Napraw to, na pewno cache, i przy okazji posprzataj trzy inne pliki.

Skill

Stack: [STACK]. Srodowisko: [SRODOWISKO]. Objaw (co czlowiek widzi): [OBJAW].

Repro / dowod (kroki, nie sciana logu):
[REPRO]

To NIE jest skill `debug-logi`. Tam: 3 hipotezy Z LOGU i stop. Tu pelna petla 4 faz. NIE PISZ PATCHA NA WEJSCIU.

Zwracasz, w tej kolejnosci:

Użyj z tym narzędziem

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

Pytania

Jak użyć skilla "Debug systematyczny (4 fazy)" 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 masz juz minimalne repro i oczywisty typo. Nie gdy wklejka zawiera sekrety (klucze, tokeny, PESEL) - najpierw wytnij. Nie do exploitow. Nie zamiast debug-logi, gdy chcesz tylko 3 hipotezy z logu i stop.