debugging

Zestaw umiejętności debugowania, które prowadzą Cię przez cztery fazy: badanie przyczyny głównej, analizę wzorców, testowanie hipotez i implementację poprawki. Zawiera narzędzia do śledzenia błędów wstecz przez stos wywołań, walidacji danych na każdej warstwie aplikacji oraz weryfikacji poprawek przed potwierdzeniem ukończenia zadania. Gwarantuje, że nie zaczniesz naprawiać, zanim nie zrozumiesz, skąd błąd się wziął.

1. Zainstaluj skill debugowania w swoim środowisku Claude, dodając go do katalogu skills. Skill zawiera cztery podumiejętności: systematic-debugging, root-cause-tracing, defense-in-depth i verification-before-completion.

2. Gdy napotkasz błąd w produkcji lub test się nie powiedzie, zacznij od systematic-debugging. Ta umiejętność przeprowadzi Cię przez czterofazowy proces: najpierw zbadaj przyczynę główną, następnie przeanalizuj wzorce, postaw hipotezę i dopiero wtedy wdrażaj poprawkę. Kluczowa zasada: nigdy nie naprawiaj bez zbadania przyczyny głównej.

3. Jeśli błąd pojawia się głęboko w stosie wywołań lub w nieoczekiwanym miejscu, użyj root-cause-tracing. Ta umiejętność pomoże Ci prześledzić błąd wstecz przez stos wywołań, aby znaleźć, gdzie dane stały się nieprawidłowe, i napraw problem u źródła zamiast objawów.

4. Po zidentyfikowaniu przyczyny głównej zastosuj defense-in-depth validation. Dodaj walidację na czterech warstwach: punkt wejścia, logika biznesowa, zabezpieczenia środowiska i instrumentacja debugowania. To uniemożliwi powtórzenie się tego samego błędu.

5. Zanim stwierdzisz, że zadanie jest ukończone, użyj verification-before-completion. Uruchom komendy weryfikacyjne i potwierdź wynik. Druga kluczowa zasada: nigdy nie potwierdzaj ukończenia bez świeżych dowodów weryfikacji.

6. Wybierz odpowiednią podumiejętność na podstawie objawu: test failure → systematic-debugging, błąd w złym miejscu → root-cause-tracing, powtarzający się błąd → defense-in-depth, potwierdzenie poprawki → verification-before-completion.