Debugging

---
name: debugging
description: "Systematic four-phase debugging: reproduce, locate, fix, verify"
---

# 系统化调试

## 工具

| 工具 | 类型 | 用法 | 调用方式 |
|:---|:---|:---|:---|
| 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 更新项目约定。