debug-to-root-cause
/debug-to-root-cause
Szuka przyczyny źródłowej błędów i niestabilnych testów przez odtworzenie, izolację i weryfikację hipotez przed poprawką.
- Autor
- wastedcode ↗
- Repozytorium
- truecast ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 17.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 17.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Szuka przyczyny źródłowej błędów i niestabilnych testów przez odtworzenie, izolację i weryfikację hipotez przed poprawką.
Oryginalny opis (EN)
Use whenever something is broken, flaky, or behaving unexpectedly — find the root cause systematically (reproduce, isolate, hypothesize, verify) and fix the cause, not the symptom. Never shotgun-edit.
Jak działa
- The method
- The discipline
Podgląd SKILL.md
---
name: debug-to-root-cause
description: Use whenever something is broken, flaky, or behaving unexpectedly — find the root cause systematically (reproduce, isolate, hypothesize, verify) and fix the cause, not the symptom. Never shotgun-edit.
---
# Debug to root cause — science, not guessing
Systematic debugging fixes it the first time (~95%); guess-and-change does not (~40%). The discipline is
a scientific loop, and its first rule is **reproduce before you touch anything.**
## The method
1. **Reproduce reliably.** A bug you can't trigger on demand you can't fix or verify. Pin down the exact
inputs/state/sequence; shrink to the smallest reproduction. For "intermittent," find what makes it
deterministic (timing, ordering, data, concurrency).
2. **Isolate by bisection.** Make a hypothesis that eliminates ~half the system; binary-search the cause
(bisect commits with `git bisect`, comment out halves, add a probe at the midpoint). Narrow fast.
3. **Hypothesize → predict → test.** State what you think is wrong, predict what you'd see if so, run the
one experiment that confirms or kills it. **Change one thing at a time** — multiple simultaneous
changes destroy the signal.
4. **Fix the cause, not the symptom.** Once the mechanism is proven, treat the *cause*. A fix that makes
the symptom vanish without explaining *why* is a future re-occurrence.
5. **Verify + regression-test.** Confirm the fix on the reproduction; add a test that would have caught it
so it can't come back.
## The discipline
- **Read the actual error / stack / logs** — don't pattern-match to a remembered fix. The trace usually
names the seam.
- If you don't understand *why* the fix works, you haven't found the root cause — keep going.
- Resist the shotgun ("change five things and re-run") — it may mask the bug and add new ones.
Wersje
W bazie nie ma innych skilli o nazwie debug-to-root-cause.
Migawka bazy z 13.11.2026 · wersja paczki 48ff64f69825 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100debug
Szuka przyczyny źródłowej błędów systematycznie: odtworzenie, izolacja, hipotezy i naprawa z użyciem TDD przy awariach, wyjątkach i regresjach. - 92debug
Szuka przyczyny źródłowej błędu przed poprawką, także wtedy, gdy poprawka wydaje się oczywista. - 100systematic-debugging
Prowadzi czterofazowe debugowanie przyczyny źródłowej: odtworzenie, porównanie wzorców, hipoteza i poprawka z testami, gdy błędy są niejasne, dwie poprawki zawiodły lub objawy wracają. - 90debug
Debuguje problemy ustrukturyzowaną diagnozą: odtworzenie, izolacja, ustalenie przyczyny źródłowej i naprawa, przy błędach, nieoczekiwanym zachowaniu i padających testach. - 100debug-root-cause
Szuka i naprawia systematycznie przyczyny błędów, awarii i nieudanych testów w JavaScript, TypeScript i Pythonie, zamiast zgadywać poprawkę. - 100debug-protocol
Prowadzi debugowanie opartego na dowodach w 5 etapach: odtworzenie, dowody, diagnoza, poprawka i potwierdzenie, z zakazem ruszania kodu przed wskazaniem przyczyny źródłowej.