Systematic Debugging

---
name: systematic-debugging
description: 结构化调试 — Bug 修复时自动激活
---
## 触发: 需求含 bug/fix/error/crash/失败/报错

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

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

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

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

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

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