superpowers-debug
Systematyczne debugowanie: odtwórz błąd, wyizoluj przyczynę, napraw i dodaj testy
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do debugowania, który prowadzi Cię przez metodyczny proces rozwiązywania problemów. Kiedy napotykasz błędy runtime'u, niestabilne testy lub nieoczekiwane zachowanie, użyj tego narzędzia do odtworzenia problemu, minimalizacji zakresu, sformułowania hipotez, dodania logowania diagnostycznego, wdrożenia poprawki i zabezpieczenia się testem regresyjnym. Idealny do szybkiego ustalenia pierwotnej przyczyny i zapobiegania powtórzeniu się błędu.
Jak używać
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.