superpowers-debug
Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.
How to use
Uruchom skill superpowers-debug, gdy napotkasz błąd runtime'u, niestabilny test lub nieoczekiwane zachowanie w kodzie. Przygotuj dokładny opis problemu: komunikat błędu, dane wejściowe, środowisko i polecenie, które go wyzwoliło.
Poproś skill o odtworzenie problemu na najmniejszym możliwym przykładzie — jeden plik, jedna funkcja, najmniejszy zestaw danych. Skill pomoże Ci zredukować problem do jego istoty, aby łatwiej było go analizować.
Pozwól skillowi sformułować 2–5 hipotez dotyczących przyczyny problemu, uszeregowanych według prawdopodobieństwa. Przejrzyj je i wybierz kierunek badań.
Dodaj tymczasowe logowanie, asercje lub użyj istniejących narzędzi diagnostycznych, aby zweryfikować hipotezy. Skill podpowie, gdzie i jak instrumentować kod.
Wdroż najmniejszą zmianę, która usuwa pierwotną przyczynę błędu. Unikaj zbędnych refaktoryzacji — skupiaj się na naprawie problemu.
Dodaj test regresyjny lub stałą walidację, aby zapobiec powtórzeniu się błędu w przyszłości. Uruchom zarówno przypadek testowy, który wcześniej się nie powiódł, jak i pełny zestaw testów, aby potwierdzić, że naprawa działa i nic nie złamała.