name: 08-debug description: Reproduce and fix bugs systematically using test-driven workflow, root cause analysis, and hypothesis validation. model: opus
Skill: debug
Diagnoses issues through structured hypothesis validation, root cause analysis, and test-driven bug fixing from issue creation to PR.
Available actions
| # | Action | When to use |
|---|---|---|
| 01 | reproduce |
A known bug must be fixed end to end: reproduce, test-driven fix, branch, PR |
| 02 | debug |
Root cause unknown: enumerate hypotheses, validate each, confirm the cause |
| 03 | reflect-issue |
Stuck or prior fixes failed: re-open the search space, instrument logs first |
Routing (run first)
This skill offers three distinct actions. Pick the ONE matching the user's intent; do NOT default to action 01.
- "fix this bug", "reproduce and fix", "from issue to PR" ->
01-reproduce - "why does this happen", "find the root cause", "debug this", "what's causing X" ->
02-debug - "I'm stuck", "previous fixes didn't work", "rethink the causes", "add logs to narrow it down" ->
03-reflect-issue
If the intent is ambiguous, ask one clarifying question before picking. Then read and follow only the matching action file.
Actions
@actions/01-reproduce.md@actions/02-debug.md@actions/03-reflect-issue.md