名称: 调试技能 描述: 用于查找和修复bug的系统化调试框架 - 包括根因分析、多层防御验证和验证协议 使用时机: 当遇到bug、测试失败、意外行为或在声称完成前需要验证修复时 版本: 1.0.0 语言: 全部
调试技能
一套系统化调试方法论的集合,确保在尝试修复前进行彻底调查。
可用子技能
系统化调试
位置: systematic-debugging/SKILL.md
四阶段调试框架:根因调查 → 模式分析 → 假设测试 → 实施。铁律:先调查根因,后尝试修复。
根因追溯
位置: root-cause-tracing/SKILL.md
通过调用栈向后追踪bug以找到原始触发点。不要修复症状 - 找到无效数据的来源并在源头修复。
多层防御验证
位置: defense-in-depth/SKILL.md
在数据传递的每一层进行验证,使bug在结构上不可能发生。四层:入口点 → 业务逻辑 → 环境防护 → 调试工具。
完成前验证
位置: verification-before-completion/SKILL.md
在声称成功前运行验证命令并确认输出。铁律:没有新鲜验证证据前不声称完成。
使用时机
- 生产环境中的bug → 从系统化调试开始
- 堆栈追踪深处的错误 → 使用根因追溯
- 修复bug时 → 在找到根因后应用多层防御验证
- 即将声称“完成”时 → 使用完成前验证
快速调度
| 症状 | 子技能 |
|---|---|
| 测试失败,意外行为 | 系统化调试 |
| 错误出现在错误位置 | 根因追溯 |
| 相同bug反复出现 | 多层防御验证 |
| 需要确认修复有效 | 完成前验证 |
核心哲学
“系统化调试比猜测和试错更快。”
从实际调试会话中:
- 系统化方法:15-30分钟修复
- 随机修复方法:2-3小时试错
- 首次修复率:95% vs 40%