AGENT SKILL
systematic_debugging
Use when diagnosing a bug, failing test, or unexpected behavior — drive a methodical reproduce → isolate → hypothesize → fix → verify loop instead of guessing. Prevents thrashing and repeated edits to the same file.
- License 许可
- Apache-2.0
- 最近更新
- 2026-09-13
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- systematic_debugging
- description
- Use when diagnosing a bug, failing test, or unexpected behavior — drive a methodical reproduce → isolate → hypothesize → fix → verify loop instead of guessing. Prevents thrashing and repeated edits to the same file.
03 SKILL.md 正文
Skill: systematic_debugging
Purpose
Find and fix the root cause of a defect through a disciplined loop rather than trial-and-error edits. Reduces rework and keeps changes minimal and targeted.
Required Input
- A description of the symptom and how it was observed (error, failing test, wrong output).
- The command or steps that trigger it, if known.
- Relevant scope: file(s), module, or feature area.
Output Format
- A minimal reproduction (command or test).
- The identified root cause, stated plainly.
- The smallest fix that addresses the cause (not the symptom).
- Verification evidence: the command run and its result.
Execution Rules
- Reproduce first. Establish a reliable, minimal repro before changing code. If you cannot reproduce it, gather more signal rather than guessing.
- Isolate. Narrow the failure to the smallest scope — bisect, add focused assertions, or read the failing path. Form one hypothesis at a time.
- Confirm the cause before fixing. State why the bug happens and back it with evidence. Do not edit speculatively.
- Fix the cause, minimally. Avoid broad rewrites. Do not repeatedly hammer the same file — if you are on the third edit, step back and re-diagnose.
- Verify. Re-run the repro and the relevant tests (
make test/ focusedpytest). Add a regression test when practical (test-driven-development). - Record. Capture any non-obvious gotcha in
memory/learnings.md. - Comply with governance:
.github/architecture.md,.github/standards.md.
04 同仓库更多 Skills
writing-plans
暂无简介
★ 0
writing-clearly-and-concisely
暂无简介
★ 0
verify_changes
暂无简介
★ 0
validate_module_structure
暂无简介
★ 0
using-git-worktrees
暂无简介
★ 0
ui-ux-pro-max
暂无简介
★ 0