# Systematic Debugging

> 结构化调试 — Bug 修复时自动激活

- Skill: `wenjunduan/systematic-debugging` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wenjunduan/systematic-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wenjunduan/systematic-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wenjunduan (https://skillmd.com/u/wenjunduan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wenjunduan/systematic-debugging

---

## 触发: 需求含 bug/fix/error/crash/失败/报错

## 四阶段 (不允许跳过)

### 1. 复现
- 找到稳定触发步骤
- 写失败测试证明 bug 存在
- **不能复现 = 不能修复, 先搞清楚条件**

### 2. 根因追踪
- 从错误往上追调用链
- 搜索项目代码找相关逻辑
- 确认根因, 不是表面症状

### 3. 防御性修复
- 修根因, 不绕症状
- 添加防御检查防同类
- 失败测试变绿

### 4. 验证
- 全量测试无回归
- 搜索同类 bug (ast-grep 如可用)
- lessons.md 记录

## 禁止
- 看到报错就改代码, 没有先复现
- 只修症状不查根因
- 改完不跑测试