systematic-debugging

rozwer 的头像作者 rozwer

用于错误/测试失败。重现、隔离根本原因、修复并用证据验证。

📖 中文导读:用于错误/测试失败。重现、隔离根本原因、修复并用证据验证。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: systematic-debugging description: Use for bugs/test failures. Reproduce, isolate root cause, fix, and validate with evidence.

Workflow

  1. Reproduce the issue reliably (capture exact commands, inputs, and environment).
  2. Collect evidence (logs, stack traces, failing tests, minimal repro).
  3. Narrow scope (bisect or localize to the smallest function/module).
  4. Form a hypothesis (one likely root cause) and a test to falsify it.
  5. Apply the smallest fix that addresses the root cause.
  6. Validate (re-run the repro; run the tightest relevant tests; watch for regressions).
  7. Add a guardrail if appropriate (assertion, validation, or targeted test).

Output expectations

  • State: repro steps, hypothesis, and the verification you ran.
  • Prefer minimal diffs over broad refactors.