用途:在任何技术问题出现时使用,包括测试失败、生产缺陷、意外行为、性能问题、构建失败与集成问题。核心原则是先找到根因再修复,只治症状视为失败。
主要能力:给出四阶段流程。阶段一为根因调查:仔细阅读错误信息与堆栈、稳定复现、检查最近改动,在多组件系统中于各组件边界加诊断日志以定位出错层,并沿数据流回溯来源。阶段二为模式分析:寻找可用的相似实现、完整阅读参考实现、列出工作与故障版本的差异、理解依赖与假设。阶段三为假设与验证:提出单一明确假设、做最小改动测试、一次只改一个变量,未验证前不叠加修复。阶段四为实施:先写可复现的失败测试,再做单一根因修复,最后验证原问题与其它测试。若三次以上修复失败,应停止并质疑架构,而非继续尝试第四次。
使用方式:按阶段顺序执行,前一阶段未完成不得提出修复。附带技术文档包括 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md,可结合 related skills 中的 superpowers:verification-before-completion 使用。
适用场景与限制:文档称系统化方式通常 15-30 分钟修复,随机修复约 2-3 小时反复;一次修复率约 95% 对 40%,引入新缺陷接近零。若调查确认问题确实是环境性、时序相关或外部因素,应记录调查过程并加入重试、超时、错误提示与监控日志。文档指出 95% 的“无根因”案例实为调查不完整。该技能为流程规范,不包含具体安装命令,官方安装方式暂未提供。