用途:用于处理任何技术问题,包括测试失败、生产环境缺陷、意外行为、性能问题、构建失败和集成问题。尤其适合时间紧迫、看似只需“快速修复”、已尝试多次修复或尚未完全理解问题时使用。
主要能力:以四阶段流程约束调试行为。第一阶段根因调查:仔细阅读错误信息与堆栈、稳定复现问题、检查近期变更(git diff、提交、依赖、配置、环境差异),在多组件系统中于各组件边界添加诊断日志以定位失败层,并沿调用栈向上追踪数据来源。第二阶段模式分析:寻找可用的相似代码、完整阅读参考实现、列出工作与故障之间的所有差异、理解依赖与假设。第三阶段假设与验证:提出单一明确假设,做最小改动逐一验证,失败则形成新假设而非叠加修复。第四阶段实现:先创建失败测试用例,再实施单一根因修复,最后验证测试通过且未破坏其他测试。
使用方式:按阶段顺序执行,未完成第一阶段不得提出修复。若修复失败,少于三次则回到第一阶段重新分析;达到三次及以上应停止并质疑架构,与人类伙伴讨论后再继续。目录中提供 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等配套技术,并关联 superpowers:test-driven-development 与 superpowers:verification-before-completion 技能。
限制:资料未提供安装命令、平台支持、收费方式或具体工具集成细节。若系统化调查后确认问题确属环境、时序或外部因素,应记录调查过程并实施重试、超时、错误提示等处理,但资料指出约 95% 的“无根因”情况实为调查不完整。