用途:在遇到任何技术问题时使用,包括测试失败、生产环境 bug、异常行为、性能问题、构建失败和集成问题。尤其适用于时间紧迫、看似只需“快速修一下”、已尝试多次修复、上一次修复无效或尚未完全理解问题的场景。
主要能力:提供四阶段调试流程。阶段一为根因调查,要求仔细阅读错误信息与堆栈、稳定复现问题、检查近期变更,并在多组件系统中各组件边界加日志以定位故障层;对深层调用栈可采用回溯追踪。阶段二为模式分析,寻找可用的相似示例、完整对照参考实现、列出工作与故障之间的所有差异、理解依赖与假设。阶段三为假设与测试,要求形成单一明确假设,用最小改动、一次只改一个变量来验证,失败则重新提出新假设而非叠加修复。阶段四为实施,先创建失败测试用例,再做单一修复并验证;若修复无效,少于三次则回到阶段一并带着新信息重新分析,三次及以上应停下质疑架构,并与人类伙伴讨论。
使用方式:该技能以流程规范形式使用。实施阶段第一步可配合 superpowers:test-driven-development 技能编写失败测试;完成后可配合 superpowers:verification-before-completion 验证修复。目录中另提供 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等辅助技术。若系统化调查后发现确为环境、时序或外部因素,视为已完成流程,应记录调查内容并实现相应处理与监控。
限制与注意:资料明确警告,不要把“快速修一下、稍后再查”“先改个值试试”“一次改多处”“跳过测试手动验证”等当作理由;也不要在多次失败后继续提出第四种修复。资料称 95% 的“无根因”情况实为调查不完整。价格、平台和具体安装命令暂未提供。