systematic-debugging
/systematic-debugging
Odtwarza błąd, stawia hipotezę i dowodzi przyczyny przed zmianą kodu, a potem robi minimalną poprawkę z testem zabezpieczającym.
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 03.08.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
Odtwarza błąd, stawia hipotezę i dowodzi przyczyny przed zmianą kodu, a potem robi minimalną poprawkę z testem zabezpieczającym.
Oryginalny opis (EN)
Use when something is broken — a failing test, panic, stack trace, error log, or wrong behavior whose cause isn't obvious. Reproduce it, form a hypothesis, PROVE the cause before changing code, then make the minimal root-cause fix and guard it with a test. For deep cases, hand off to the debugger subagent.
Jak działa
- The method
- Red flags — you're not debugging, you're flailing
- Done means
Podgląd SKILL.md
---
name: systematic-debugging
description: Use when something is broken — a failing test, panic, stack trace, error log, or wrong behavior whose cause isn't obvious. Reproduce it, form a hypothesis, PROVE the cause before changing code, then make the minimal root-cause fix and guard it with a test. For deep cases, hand off to the debugger subagent.
allowed-tools: Read, Grep, Glob, Bash, Edit
---
# Systematic debugging
Fix the cause, not the symptom — and prove the cause before you touch code.
## The method
1. **Reproduce** — get a reliable, minimal repro (a failing test is ideal). No repro → no fix.
2. **Hypothesize** — one specific, falsifiable guess about the cause ("X is null because Y").
3. **Prove it** — instrument/log/inspect to confirm the hypothesis *before* editing. If the
evidence contradicts it, form a new hypothesis. Don't guess-and-change.
4. **Minimal fix** — change the smallest thing that addresses the proven root cause.
5. **Verify** — re-run the repro; it passes. Run the surrounding tests; nothing regressed.
(See `verification-before-completion`.)
6. **Guard** — add/extend a test that would have caught it, so it can't silently return.
For a nasty one, delegate to the **`debugger`** subagent (or the `triage` command) — it
forms a hypothesis, proves it, and proposes the minimal fix.
## Red flags — you're not debugging, you're flailing
- **Changing code before reproducing** the problem.
- **Fixing the symptom** (swallow the error, bump the timeout) instead of the cause.
- **Several changes at once** — you won't know which one mattered.
- "It went away" with **no explanation of why** — it'll come back.
- Re-running hoping for a different result without changing your hypothesis.
## Done means
Root cause **proven** (not assumed) · minimal fix · repro now green · a regression test
added · no new failures. Anything less is **UNVERIFIED**.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · dshakes/compass | 90 | MIT |
| magnus919/agent-skills | 100 | MIT |
| FrancoStino/opencode-skills-collection | 100 | MIT |
| foryourhealth111-pixel/Vibe-Skills | 100 | Apache-2.0 |
| GanyuanRan/Aegis | 100 | MIT |
| rootcastleco/rei-skills | 100 | MIT |
| jkaloger/lazyspec | 100 | MIT |
| innei/ryugi | 100 | MIT |
| yusixian/anjian | 100 | MIT |
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki 148efb8fb3dd (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
- 100root-cause-debugging
Szuka przyczyny źródłowej przed zmianą kodu: odtwarza błąd, czyta pełny komunikat, testuje jedną hipotezę naraz i po trzech nieudanych poprawkach zatrzymuje się. - 96fix
Naprawia błąd metodą Concordia: najpierw odtwarza go w nieprzechodzącym teście, szuka przyczyny, stosuje najmniejszą poprawkę i ją dowodzi. - 100bug-fix
Naprawia błędy zgłoszone w projekcie Device: odtwarza je, pisze mały test, znajduje przyczynę i potwierdza poprawkę. - 90debugging
Diagnozuje błąd: odtwarza go, czyta cały komunikat, sprawdza zmiany i nazywa przyczynę przed zmianą kodu. - 100debugging-playbook
Debuguje zgłoszony błąd krok po kroku: odtwarza go, zawęża przyczynę logami i bisekcją, stosuje najmniejszą poprawkę i dodaje test regresji. - 100debugging
Szuka prawdziwej przyczyny zepsutego działania: odtwarza je, instrumentuje ścieżkę, zawęża do jednego mechanizmu i dowodzi poprawki testem.