systematic-debugging

技能简介

systematic-debugging 是一套系统化调试方法论，引导开发者在遇到 Bug、测试失败或意外行为时，先定位根本原因再实施修复，而不是凭直觉猜测。它通过四个阶段的结构化流程，帮助你避免“症状修复”和反复试错，提升问题解决效率。

使用场景

• 测试失败或构建失败，需要定位具体原因
• 生产环境出现 Bug 或性能异常
• 多个组件集成时出现数据传递或环境配置问题
• 已尝试多次修复但问题仍在，需要重新审视
• 时间压力大时，用系统化方式代替“应急猜测”

使用方法

该技能需要嵌入支持 Agent 的 IDE 或 CLI 环境中使用。确保你的环境中已配置好技能目录，然后在 AGENTS.md 中声明引用即可启用。若使用 Claude Code 或类似工具，可直接通过技能命令调用：

# 查看已安装技能
claude skills list

# 添加技能（如果通过技能市场安装）
claude skills add systematic-debugging

启用后，当遇到技术问题时，按四个阶段推进：Phase 1 根本原因调查（仔细阅读错误信息、稳定复现、检查近期变更、在多组件系统中添加诊断日志）；Phase 2 模式分析（对比工作示例与失败案例的差异）；Phase 3 假设与测试（每次只改一个变量验证假设）；Phase 4 实施修复（先写失败测试，再做最小修复，最后验证）。

注意事项

• 铁律：不做根本原因调查，就不许提修复方案。 若未完成 Phase 1，禁止直接动手修改代码。
• 即使问题看似简单，也请走完整流程——简单 Bug 同样有根本原因。
• 修复连续失败 3 次时，立即停止并质疑整体架构设计，不要继续尝试第 4 个补丁。
• 若系统包含多个组件（如 CI 流水线、API→数据库链路），务必先加日志定位故障层，再深入分析，而不是猜测。