debug-with-file
Debugowanie oparte na hipotezach z dokumentacją procesu odkrywania i automatyczną korektą błędów
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do zaawansowanego debugowania, który dokumentuje każdy krok eksploracji kodu i ewolucję Twojego rozumienia problemu. Zamiast zgadywać, tworzysz testowalne hipotezy, zbierasz dowody z logów, a następnie automatycznie koregujesz błędne założenia. System zapisuje całą historię nauki, nawet z nieudanych prób, aby uniknąć powtarzania tych samych błędów. Idealne do złożonych błędów, gdzie tradycyjne debugowanie zawodzi.
Jak używać
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.
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.
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.
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.
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ę.
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.