debug-with-file

Interactive hypothesis-driven debugging with documented exploration, understanding evolution, and analysis-assisted correction.

1. Uruchom skill z opisem błędu, przekazując go jako argument BUG="opis błędu lub komunikat błędu". System automatycznie sprawdzi, czy istnieje już sesja debugowania dla tego problemu — jeśli tak, wznowi pracę z wcześniejszymi notatkami.

2. W trybie eksploracji skill zlokalizuje źródło błędu w kodzie, udokumentuje Twoje pierwsze rozumienie problemu w pliku understanding.md i wygeneruje listę testowanych hipotez. Przeanalizuje każdą hipotezę pod kątem logiki i spójności z kodem.

3. Dodaj instrumentację logowania NDJSON do kodu zgodnie z sugestiami skilla, aby zbierać dowody podczas reprodukcji błędu. Uruchom aplikację i pozwól systemowi zbierać dane diagnostyczne.

4. Po zebraniu logów skill przejdzie w tryb analizy — przeanalizuje plik debug.log, zweryfikuje każdą hipotezę względem rzeczywistych danych i automatycznie skoryguje błędne założenia w understanding.md, zaznaczając przekreślone błędy i dodając poprawne wyjaśnienia.

5. Na podstawie potwierdzonej hipotezy skill zaproponuje i zastosuje poprawkę do kodu, a następnie zweryfikuje, że błąd został usunięty. Jeśli wyniki są niejednoznaczne, doda więcej punktów logowania i wznowi iterację.

6. Po naprawie skill wyczyści sesję debugowania i zachowa całą historię nauki w understanding.md, aby przyszłe debugowanie tego samego lub podobnego problemu było szybsze.