用途:为任何技术问题提供分步调试流程,包括测试失败、生产缺陷、异常行为、性能问题、构建失败与集成问题。核心原则是先找到根因再修复,禁止在完成第一阶段前提出修复方案。
主要能力:四阶段流程。第一阶段根因调查:仔细阅读错误与堆栈、稳定复现、检查近期变更(代码、依赖、配置、环境、数据),在多组件系统中于各组件边界加诊断日志以定位失败层,并沿调用栈回溯数据流。第二阶段模式分析:寻找可用的相似实现、完整阅读参考实现、列出工作与故障之间的所有差异、理解依赖与假设。第三阶段假设与测试:提出单一明确假设,做最小改动、一次只改一个变量,验证后再继续。第四阶段实现:先写失败测试用例,再实施单一修复,最后验证修复且不破坏其他测试。
使用方式:按阶段顺序执行,每阶段完成才进入下一阶段。若修复失败,少于三次回到第一阶段重新分析;三次及以上应停止并质疑架构,与人类伙伴讨论后再继续。目录内提供 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md 等支持技术,并关联 superpowers:test-driven-development 与 superpowers:verification-before-completion 技能。
适用场景:时间紧迫、看似只需一处快速修复、已尝试多次修复、前次修复无效或尚未完全理解问题时尤其适用。
限制:资料未提供安装命令、平台支持、收费与价格信息,暂未提供。该技能为流程性指导,不替代具体项目的测试框架或日志工具。