核心用法
Debug Methodology 是一套从真实生产事故提炼的系统性故障排查框架，激活条件包括：意外错误、服务故障、回归 bug、部署问题，或任何修复尝试失败两次以上。核心机制为"根因强制门"——任何修复方案必须通过三项检验：明确实际问题、追溯发生原因、确认修复消除根因而非规避症状。
五阶段工作流：
- STOP 阶段：记录精确症状、最后正常状态、环境上下文（进程启动方式、虚拟环境、运行时版本），禁止无记录重启
- Hypothesize 阶段：按优先级形成单一假设——自身变更→环境变更→外部输入→全新 bug
- Test 阶段：单次变更验证，失败立即回滚
- Patch-Chain 检测：两次修复失败强制停止，全量回滚并重返 Phase 1
- Post-Fix 验证：确认解决原始问题、无回归、移除修复后 bug 复现（因果性检验）
部署安全硬规范：
- 铁律：禁止服务器直编，禁止无备份覆盖
- 标准流程：PULL→EDIT→VERIFY（node -c / 模块加载测试）→BACKUP→PUSH→RESTART→HEALTH
- 复杂多行代码必须本地编写完整文件后 scp 上传，禁止 sed 多行插入（易导致静默语法损坏）
显著优点
1. 根因强制机制：通过"5 Whys"和"移除修复测试"从根本上杜绝 workaround 成瘾
2. 防修复链设计：两次失败即触发全量回滚，避免症状层叠修复导致的灾难性复杂化
3. 部署安全硬化：语法预检、备份强制、健康检查形成完整闭环，显著降低生产事故风险
4. 反模式系统化：明确识别 drunk man（随机修复）、streetlight（舒适区排查）、cargo cult（盲目复制）等认知陷阱
潜在局限
- 启动成本：严格的阶段 gates 和文档要求在小规模/紧急场景下可能延缓响应
- 假设依赖：Hypothesize 阶段的优先级排序（自身变更→环境→外部→新 bug）在高度耦合系统中可能漏判
- 工具链预设：部署流程深度绑定 Node.js/PM2 生态，对其他运行时（Python uWSGI、Java systemd 等）需适配
适合人群
- 生产环境运维/SRE 工程师
- 需处理历史遗留系统的后端开发者
- 团队协作中频繁遭遇"修复引入新 bug"场景的技术负责人
常规风险
- 误判根因："5 Whys"链条过长时可能引入错误因果关联，需结合日志实证
- 回滚犹豫：心理层面难以执行两次失败后的强制回滚，导致违反协议
- sed 陷阱：即使文档明文禁止，紧急状态下仍可能误用 sed 多行插入造成静默损坏
- 用户沟通：HEALTH 检查前告知用户刷新，可能暴露不稳定状态