Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

systematic-debugging

/systematic-debugging

Odtwarza błąd, stawia hipotezę i dowodzi przyczyny przed zmianą kodu, a potem robi minimalną poprawkę z testem zabezpieczającym.

Repozytorium
compass ↗
Licencja
MIT
Ostatnia zmiana repozytorium
03.08.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 03.08.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

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

  1. The method
  2. Red flags — you're not debugging, you're flailing
  3. Done means
Sekcje z nagłówków SKILL.md, w oryginale · 32 linii, 241 słów
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

RepozytoriumWynikLicencja
Ta strona · dshakes/compass90MIT
magnus919/agent-skills100MIT
FrancoStino/opencode-skills-collection100MIT
foryourhealth111-pixel/Vibe-Skills100Apache-2.0
GanyuanRan/Aegis100MIT
rootcastleco/rei-skills100MIT
jkaloger/lazyspec100MIT
innei/ryugi100MIT
yusixian/anjian100MIT

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.

Uwagi i zgłoszenia

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