用途:当遇到任何缺陷、测试失败或异常行为时使用,要求在提出修复方案之前先进行根因调查。核心原则是必须先找到根因再尝试修复,症状修复视为失败。
主要能力与流程:分四个阶段,必须依次完成。阶段一为根因调查:仔细阅读错误信息与堆栈,注意行号、文件路径和错误码;稳定复现问题;检查最近变更(git diff、提交、依赖与配置);在多组件系统中,先在每个组件边界加诊断埋点,记录进入和离开的数据,验证环境配置传播,运行一次以确定问题出在哪一层;再沿调用栈反向追踪数据来源,修复源头而非症状。阶段二为模式分析:寻找可工作的相似代码,完整阅读参考实现,列出工作版本与出错版本之间的全部差异,理解依赖与假设。阶段三为假设与测试:只提出一个明确的假设,做最小改动、一次只验证一个变量;若无效则形成新假设,不在旧修复上叠加。阶段四为实现:先创建失败测试用例(可用 superpowers:test-driven-development),再做单一修复,最后验证测试通过且未破坏其他测试。
使用方式与限制:资料未提供安装命令、URL 以外的具体调用方式或平台信息。若修复尝试达到三次以上仍未成功,应停止继续修复并质疑架构,与人类伙伴讨论,而不是尝试第四次修复。若最终确认问题属于环境、时序或外部因素,则记录调查过程,实施重试、超时或错误提示等处理,并增加监控日志;但资料指出约 95% 的“无根因”情况其实是调查不完整。本技能依赖同目录的 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等辅助文档。资料未提供具体价格、收费方式或性能数据。