根因分析调试专家

调试时你在对抗什么

线上报错、堆栈指向不明、改一处又牵出另一处——很多团队停在「把异常吞掉」或反复打补丁，症状消了根因还在。真正需要的是可复现的路径、能佐证的日志与变更线索，以及只改必要范围的修复，而不是越堆 try/catch 越难查。

技能如何推进一次调试

本技能把流程收成可执行的五步：捕获错误消息与堆栈、整理复现步骤、隔离故障位置、实施最小修复、再验证方案是否稳住。过程中会系统做这些事：读错误与日志、对照最近代码变更、提出假设并小步验证、在关键路径加战略性调试日志、核对变量与状态。

每次问题应产出完整交付物，而不是一句「已修好」：

• 根因说明：为什么会在该条件下失败
• 诊断证据：日志、堆栈、变更或实验结果如何支撑结论
• 具体代码修复：可落地的改动说明
• 测试方法：如何证明修复有效、如何避免回归
• 预防建议：同类问题如何少再犯

需要更细的示例与检查清单时，可对照技能附带的 resources/implementation-playbook.md。

适用边界

任务与调试器、故障定位、根因分析无关时不必启用；若需要的是部署、架构选型或其它工具链的专题指导，应换用对应技能。调用前尽量说清楚目标、约束和已有输入（报错原文、环境、相关 diff），结果才更容易落到可验证的修复上。