核心机制
Superpowers 系统性调试是一套强制性的四阶段调试方法论，旨在根治"随机修 bug"导致的恶性循环。其核心设计是将调试从直觉驱动转变为证据驱动的科学过程。
阶段结构
阶段 1：根本原因调查 — 禁止任何修复尝试，强制完成错误精读、稳定复现、变更追溯和数据流追踪。特别强调"如果不能复现，收集更多数据，不要猜"。
阶段 2：模式分析 — 通过寻找代码库中的正常参考实现，逐行对比识别差异，建立对问题域的完整理解。
阶段 3：假设与测试 — 采用科学方法：形成可证伪假设→最小化变更测试→验证后再继续。明确禁止"不知道却假装知道"。
阶段 4：实现 — 强制先写失败测试用例，单一修复根本原因，禁止捆绑重构。关键熔断机制：连续 3 次修复失败必须停止并质疑架构，而非继续尝试第 4 次修复。
显著优势
- 防退化机制：红旗警告和主人信号系统能即时识别违规操作
- 架构熔断：3 次失败强制转向架构层面反思，避免陷入"打地鼠"式修复
- 知识沉淀：要求将假设书面化，调试过程本身成为可复用资产
- 压力场景设计：特别针对"时间紧迫""看起来很明显"等高风险决策场景强化约束
局限性与约束
- 时间成本：完整流程在简单问题上可能显得过度
- 依赖团队纪律：主人信号机制需要协作方熟悉并配合执行
- 假阳性风险：95% 的"无根本原因"实为调查不完整，需警惕过早放弃
- 工具链要求：推荐配合
superpowers-tdd技能使用，单一使用效果受限
适用场景
- 生产环境 bug 排查
- 测试失败根因分析
- 性能问题诊断
- 集成失败调试
- 特别适合：已尝试多次修复未果、团队压力下的紧急修复决策
风险评估
方法论本身安全等级高，但执行层面存在"流程疲劳"风险——团队可能在长期压力下绕过阶段约束。建议配套 metrics 追踪修复尝试次数和返工率。