Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

debug-loop

/debug-loop

Debuguje nieudany test lub błąd uruchomieniowy w pętli opartej na hipotezach, z autonomiczną walidacją poleceń i systematycznym eliminowaniem przyczyn.

Repozytorium
agentic-qe ↗
Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 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ść35 / 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 25.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

Debuguje nieudany test lub błąd uruchomieniowy w pętli opartej na hipotezach, z autonomiczną walidacją poleceń i systematycznym eliminowaniem przyczyn.

Oryginalny opis (EN)

Use when debugging a failing test or runtime error with hypothesis-driven investigation, autonomous command validation, and systematic root cause elimination.

Jak działa

  1. Arguments
  2. Phases
  3. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 335 słów
Podgląd SKILL.md
---
name: debug-loop
description: "Use when debugging a failing test or runtime error with hypothesis-driven investigation, autonomous command validation, and systematic root cause elimination."
trust_tier: 0
domain: debugging
---

# Debug Loop

Autonomous hypothesis-driven debugging against real data. No guessing, no simulating.

## Arguments

- `<symptom>` — Description of the bug or unexpected behavior. If omitted, prompt the user.

## Phases

### Phase 1 — Reproduce
Run the exact command that shows the bug. Capture and display the REAL output. Confirm the bug is visible.

If the bug cannot be reproduced, stop and explain what was tried.

### Phase 2 — Hypothesize and Test (up to 5 iterations)
For each iteration:
1. State a specific hypothesis (e.g., "the query targets v2 tables but data is in v3 tables")
2. Run a REAL command to test it (e.g., `sqlite3 [db path] '.tables'` then `SELECT COUNT(*) FROM [table]`)
3. Record whether the hypothesis was confirmed or rejected
4. If rejected, form the next hypothesis based on what you learned

**Do NOT make code changes until you have a confirmed root cause.**

Important checks:
- Always check both v2 and v3 SQLite tables when data issues are suspected
- Check dependency versions (e.g., sqlite3 vs better-sqlite3)
- Check for hardcoded values that may have been missed

### Phase 3 — Fix
Make the minimal targeted fix. Explain:
- What the root cause was
- What you're changing and why
- What the blast radius is (which other code paths are affected)

Before applying, grep for ALL instances of the problematic pattern across the entire codebase.

### Phase 4 — Verify
Run the SAME reproduction command from Phase 1. The output must now show correct values. If it doesn't, go back to Phase 2.

Show before/after output comparison.

### Phase 5 — Regression
```bash
npm test
```
Run the full test suite. If tests fail, fix them before committing.

## Rules

- NEVER guess or simulate output — always run real commands
- NEVER make code changes before confirming root cause
- Always check for the pattern across the entire codebase, not just one file
- If blocked after 5 hypotheses, stop and ask the user for guidance

Wersje

W bazie nie ma innych skilli o nazwie debug-loop.

Identyczna treść występuje jeszcze w 3 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki e97699365ce6 (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
    Debuguje systematycznie przez badanie hipotez, gdy coś nie działa lub testy kończą się porażką, z dostępem do uruchamiania poleceń, dodawania logów i naprawiania błędów.
  • 100debug
    Diagnozuje nieudany test, build, awarię lub regresję bez edycji kodu: odtwarza objaw, sprawdza hipotezy i wskazuje przyczynę.
  • 90systematic-debugging
    Szuka przyczyny źródłowej i naprawia błąd, gdy użytkownik zgłasza awarię, błąd, nieoczekiwane zachowanie lub niezaliczony test.
  • 100debug
    Wymusza znalezienie przyczyny przed zaproponowaniem poprawki, gdy pojawia się błąd, nieudany test lub nieoczekiwane zachowanie.
  • 100debug
    Prowadzi interaktywne debugowanie w pętli sond opartej na hipotezach, przy nieznanych błędach, błędach skryptów i cichych awariach, i tworzy raport z dziennikiem sond, przyczyną i poprawką.
  • 90root-cause-debugging
    Prowadzi debugowanie oparte na hipotezach i dowodach, by znaleźć prawdziwą przyczynę błędu, awarii lub złego wyniku przed poprawką.

Uwagi i zgłoszenia

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