Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

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ą.

Repozytorium
truecast ↗
Licencja
MIT
Ostatnia zmiana repozytorium
17.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 17.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. The method
  2. The discipline
Sekcje z nagłówków SKILL.md, w oryginale · 25 linii, 261 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.