# Debugging

> Systematic four-phase debugging: reproduce, locate, fix, verify

- Skill: `wenjunduan/debugging-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wenjunduan/debugging-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wenjunduan/debugging-2/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/debugging-2

---


# 系统化调试

## 工具

| 工具 | 类型 | 用法 | 调用方式 |
|:---|:---|:---|:---|
| Superpowers debugging | Plugin Skill | 四阶段调试方法论 | 自动: 调试时触发 |
| sou | MCP | 搜索相关代码+错误模式 | `sou.search("错误关键词")` |
| chrome-devtools | MCP (Codex) | 前端运行时调试 | Codex 专属 |
| skill/tdd | VibeCoding Skill | 修复阶段写测试 | 内部加载 |

## 触发条件

- `vibe-debug` 命令直接触发
- skill/verification 2 次失败自动加载
- 用户报告 bug

## 四阶段

```
1. 复现
   → 确认 bug 可稳定复现
   → 记录 expected vs actual

2. 定位
   → sou.search("错误关键词") 搜索相关代码
   → Superpowers debugging: 二分法缩小范围
     降级: SP 未安装 → 直接二分法
   → 用证据定位，不猜测

3. 修复
   → skill/tdd: 写修复测试 (RED) → 最小修复 (GREEN)
   → 不引入新问题

4. 验证
   → 运行全测试套件
   → 记录 root cause → .knowledge/experience/mistakes.md
```

## 禁止

- 随机改代码看能不能好
- 不复现就开始修
- 同时改多处
- 不写测试就提交修复

## .ai_state

doing.md 记录调试进度。conventions.md 更新项目约定。