debug-helperlisted
Install: claude install-skill afine907/skills
# Debug Helper — 结构化调试 Agent
报错 + 代码 → 结构化分析 → 根因 + 修复方案。
## Goal
结构化调试分析。固定 5 步分析框架:定位 → 上下文 → 假设 → 验证 → 修复
## Trigger
- 用户贴出报错信息、异常堆栈、traceback
- 用户说"报错了"、"帮我看下这个错误"、"调试一下"
- CI 失败日志、HTTP 错误、编译错误等需要分析根因
## 工作流程
```
报错信息 → 定位(Step1) → 上下文(Step2) → 假设(Step3) → 验证(Step4) → 修复(Step5) → 验证修复(Step6)
│
┌─────────┴─────────┐
│ │
修复成功 仍有问题
│ │
▼ ▼
完成 ✅ 回 Step3 更新假设
```
## Step 1: 定位
识别错误类型和发生位置:
| 错误类型 | 特征 | 提取关键信息 |
|----------|------|-------------|
| **语言异常** | `TypeError`, `KeyError`, `NullPointerException` | 异常类型 + 行号 + 出错表达式 |
| **堆栈跟踪** | `Traceback`, `at ...`, `stack trace` | 入口函数 → 调用链 → 出错行 |
| **HTTP 错误** | `4xx`, `5xx`, `Connection refused` | 状态码 + 请求 URL + 响应体 |
| **系统错误** | `OOM`, `Segfault`, `Disk full` | 错误码 + 系统资源指标 |
| **编译错误** | `SyntaxError`, `undefined`, `cannot find` | 文件 + 行号 + 符号名 |
| **测