evanflow-debug
/evanflow-debug
Szuka przyczyny błędów i nietypowego zachowania, zanim napisze poprawkę, i weryfikuje hipotezę przed zmianą kodu.
- Autor
- evanklem ↗
- Repozytorium
- evanflow ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.05.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 12.05.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 błędów i nietypowego zachowania, zanim napisze poprawkę, i weryfikuje hipotezę przed zmianą kodu.
Oryginalny opis (EN)
Root-cause discipline for bugs, test failures, and unexpected behavior. Embedded grill on the hypothesis before writing fix code. Use when encountering any bug, failing test, or behavior that doesn't match expectation.
Jak działa
- Vocabulary
- When to Use
- The Flow
- Hard Rules
- Hand-offs
Podgląd SKILL.md
--- name: evanflow-debug description: Root-cause discipline for bugs, test failures, and unexpected behavior. Embedded grill on the hypothesis before writing fix code. Use when encountering any bug, failing test, or behavior that doesn't match expectation. --- # EvanFlow: Debug ## Vocabulary See `evanflow` meta-skill. ## When to Use - Test failing - User reports unexpected behavior - Production error - Code does the wrong thing under specific conditions - Anything where the immediate symptom isn't the root cause **SKIP when:** the cause is obvious and the fix is one line. Don't ceremonialize trivial bugs. ## The Flow ### 1. Reproduce - Get the exact reproduction: input, environment, steps - Reproduce locally if possible. If you can't reproduce, the bug is unverified — say so before proceeding. ### 2. Form a Hypothesis State the hypothesis explicitly: > "I think the bug is in <file>:<line> because when X happens, Y is supposed to happen but instead Z does." A vague "probably the validation" is not a hypothesis. ### 3. Embedded Grill — Challenge the Hypothesis Before writing any fix, ask: - **Symptom vs. cause**: "Is this where the bug *manifests*, or where it *originates*? Trace one step further upstream." - **Coverage**: "What other code paths share this root cause? Will the fix here leave those paths broken?" - **Reversibility**: "Does the fix have the same blast radius as the bug, or wider?" - **Test gap**: "Why didn't a test catch this? Is the test missing, wrong, or misaligned with real behavior?" - **Domain check**: "Is the bug actually behaving correctly per spec, and the spec is wrong?" ### 4. Verify the Hypothesis Before Fixing Add an instrument (log, breakpoint, test assertion) that proves the hypothesis right or wrong. **Watch the instrument fire.** If it doesn't, the hypothesis is wrong — go back to step 2. ### 5. Write a Failing Test First The test should fail because the bug exists. This is a vertical-slice TDD application — see `evanflow-tdd`. ### 6. Fix at the Root Fix where the root cause originates, not where the symptom appears. If the fix is far from the symptom, leave a comment explaining the WHY (this is one of the few cases where a code comment earns its keep). ### 7. Verify the Test Passes Run the test. Run the broader suite. Confirm no regressions. ## Hard Rules - **No fix without a failing test that demonstrates the bug.** (Same TDD principle as evanflow-tdd.) - **Fix the root, not the symptom.** Symptom-fixes are how bugs metastasize. - **Never auto-commit.** A fix gets staged; user confirms before commit. - **If you can't reproduce, say so.** Don't fix invisible bugs. ## Hand-offs - Fix complete, tests pass → if mid-plan, return to `evanflow-executing-plans`. If standalone debug, **report what was fixed and STOP**. The user decides whether to commit or take further action. - Discovered an architectural issue → `evanflow-improve-architecture` - Discovered the spec is wrong → `evanflow-brainstorming` to align on intended behavior
Wersje
W bazie nie ma innych skilli o nazwie evanflow-debug.
Migawka bazy z 13.11.2026 · wersja paczki 1601358139a4 (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ę. - 90debug
Pomaga znaleźć przyczynę błędu lub nieoczekiwanego zachowania, zanim zaproponuje poprawkę, bez zgadywania. - 100debug-root-cause
Szuka i naprawia systematycznie przyczyny błędów, awarii i nieudanych testów w JavaScript, TypeScript i Pythonie, zamiast zgadywać poprawkę. - 90investigate
Prowadzi systematyczne debugowanie: szuka przyczyny źródłowej i śledzi hipotezy przy błędach oraz testach. - 100systematic-debugging
Szuka przyczyny błędu i nieoczekiwanego zachowania na podstawie dowodów, zanim zaproponuje poprawkę. - 100systematic-debugging
Szuka przyczyny błędu i nieoczekiwanego zachowania na podstawie dowodów, zanim zaproponuje poprawkę.