（2259期）Superpowers Systematic Debugging – 四阶调试法，根因零容忍

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