用途:在出现 Bug、测试失败或行为不符合预期时,强制按“先复现、先找根因、先锁定失败”的流程调试,核心目的是修因不修表、避免猜测式修复、在修复前用测试锁定失败。
触发场景:测试失败;生产或本地出现 Bug;响应、状态、渲染或查询结果与预期不符;排查性能下降、超时、竞态或偶发失败;问题修复后再次复发。该技能明确不接受“看起来很简单直接改”“没时间先打补丁”“大概是这里改一下”这类理由。
必需流程:Phase 0 先尝试复现,若不知如何复现须停下并用可用工具询问用户复现步骤、输入或环境;Phase 1 用一句话定义问题,区分钟症状与猜测;Phase 2 通过已有测试、最小集成/单元测试、复现脚本或日志使失败可观察;Phase 3 收集可观察证据,包括完整错误与堆栈、失败输入、近期改动、环境差异、调用路径与数据流,多组件问题需在每个边界检查;Phase 4 提出单一根因假设并可由小实验证伪;Phase 5 在修复前建立失败守卫(优先自动化失败测试,也可用回归用例、最小复现脚本或日志断言);Phase 6 只做一处针对根因的最小修复,禁止捆绑多个修复、混入重构或格式化、无证据加空值保护、吞异常;Phase 7 验证原复现路径不再失败、新守卫通过、相关测试未破坏,偶发问题需重复或多条件验证。
输出契约(内部锁定):问题陈述、复现路径、证据、根因假设、失败守卫、修复、验证,七项缺一即视为未完成。
停止条件:复现多次失败则检查可观测性、环境差异或问题定义;连续三次修复未命中应怀疑结构性问题(共享状态、边界设计、职责划分),不再打第四个补丁;无法建立失败守卫时不得宣称完成,至少留下复现命令与观察结果。
限制与说明:该技能主要约束流程与证据,不提供具体语言或框架的实现代码;资料未说明其安装方式、依赖平台、收费或与其他技能的自动集成机制,这些信息暂未提供。