Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

dte-debug

/dte-debug

Szuka przyczyny źródłowej błędu i naprawia ją raz, tam gdzie schodzą się wszystkie wywołania, z powtarzalnym przypadkiem przed i po poprawce; łączy ce-debug, rails-debugger, Augment i AppSignal.

Repozytorium
dte-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.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 13.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łędu i naprawia ją raz, tam gdzie schodzą się wszystkie wywołania, z powtarzalnym przypadkiem przed i po poprawce; łączy ce-debug, rails-debugger, Augment i AppSignal.

Wyzwalacze z opisu

debug thiswhy is this failing/brokenfix this bugthis exceptionfind the root causethis test is flaky
Oryginalny opis (EN)

Track a bug to its ROOT CAUSE and fix it once where all callers route — for a failing test, an exception, a wrong result, or flaky behavior. Composes ce-debug (root-cause hypothesis loop), majestic rails-debugger, Augment for tracing call paths, AppSignal for production error context, and a runnable repro before and after the fix. Use when the user says "debug this", "why is this failing/broken", "fix this bug", "this exception", "find the root cause", or "this test is flaky". Loops over a list of bugs. Not for a broad code review (use dte-deep-reviewer) or a planned feature (use dte-feature).

Jak działa

  1. Input
  2. Procedure (per bug)
  3. For a list of bugs
  4. Degrade gracefully
  5. Done when
Sekcje z nagłówków SKILL.md, w oryginale · 40 linii, 437 słów
Podgląd SKILL.md
---
name: dte-debug
description: Track a bug to its ROOT CAUSE and fix it once where all callers route — for a failing test, an exception, a wrong result, or flaky behavior. Composes ce-debug (root-cause hypothesis loop), majestic rails-debugger, Augment for tracing call paths, AppSignal for production error context, and a runnable repro before and after the fix. Use when the user says "debug this", "why is this failing/broken", "fix this bug", "this exception", "find the root cause", or "this test is flaky". Loops over a list of bugs. Not for a broad code review (use dte-deep-reviewer) or a planned feature (use dte-feature).
---

# dte-debug — reproduce → root cause → fix once → prove it

Read `../../references/conventions.md` first (looping, **Runnable gate**, **Verify don't advise**). This
skill **finds the cause, not the symptom**, and fixes it where every caller routes through — the lazy fix
is the root-cause fix. It composes the debug tools; it does not patch the path the ticket names and walk away.

## Input
- A bug: a failing test, a stack trace/exception, a wrong output, or flaky behavior. Get a repro if missing.
- Or a **list** of bugs → handle each (serial by default — bugs in shared code interact).
- Read the project `CLAUDE.md`/`AGENTS.md`; honor interactors-not-services + the test framework.

## Procedure (per bug)
1. **Reproduce first.** Make it fail on demand — a failing test (write the smallest one if none exists), a
   console repro, or the exact request. **No repro → say so and stop guessing.** This same repro proves the
   fix at the end.
2. **Gather context.** Map the failing path with Augment `codebase-retrieval`. If it's a production error,
   pull **AppSignal** (backtrace, frequency, recent deploys, params). Read the actual flow end to end.
3. **Find the root cause.** Run **`ce-debug`** (hypothesis → test → narrow loop) and/or majestic
   **`rails-debugger`**. **Grep every caller** of the function you suspect — the bug usually lives in the
   shared function, and the report only named one symptom. Name the cause in one line before editing.
4. **Fix once, at the cause.** One guard/fix in the shared path beats a guard in every caller — and patching
   only the named path leaves sibling callers broken. Follow existing patterns; interactors not services.
5. **Prove it.** Re-run the step-1 repro → must pass. Run the project **gate** (tests + boot/eager-load
   check) → green. Add/keep a regression test that fails without the fix. A fix you can't demonstrate failing
   before and passing after is **not done**.

## For a list of bugs
One sub-agent per bug through 1–5 (serial by default), then a roll-up noting each bug's root cause, the
shared-path fix, and any sibling callers that were also affected. Report + pause per bug.

## Degrade gracefully
- No ce-debug → drive the hypothesis loop manually (bisect, log, narrow), note it.
- No AppSignal → use logs/local repro for production bugs, note production context unavailable.

## Done when
Each bug has a **runnable repro** that failed before and passes after, the **root cause named** (not just
the symptom), the fix applied **once at the shared path** with all callers checked, a regression test, and
a **green gate**. Surfaced (not silently): any caller you couldn't fix in scope.

Wersje

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

Migawka bazy z 13.11.2026 · wersja paczki 79561e75edf0 (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

  • 90dte-perf
    Szuka wąskich gardeł wydajności w aplikacji Rails, endpointach, zapytaniach i stronach, na podstawie pomiarów, i proponuje poprawki.
  • 92debug
    Szuka przyczyny źródłowej błędu przed poprawką, także wtedy, gdy poprawka wydaje się oczywista.
  • 90dte-arc-review
    Wykonuje przegląd architektury aplikacji Rails lub jej podsystemu i zapisuje raport z ustaleniami uszeregowanymi według wagi.
  • 100ra-systemic-debug
    Szuka przyczyny źródłowej błędu w kilku krokach wstecz i naprawia go u źródła, bez łatania objawów.
  • 90debug
    Szuka przyczyny źródłowej błędu, testu, awarii lub spadku wydajności przed poprawką, a potem naprawia i potwierdza ją.
  • 100claude-debug
    Przekazuje błąd lub nieprzechodzący test do Claude Code w celu analizy przyczyny źródłowej i poprawki, gdy przyczyna leży głęboko w bazie kodu.

Uwagi i zgłoszenia

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