用途:处理难缠的 Bug 和性能回归。该技能规定一套严格的诊断纪律,只有在能明确论证时才允许跳过阶段;要求先阅读项目领域术语表建立模块心智模型,并查看相关区域的 ADR。
主要流程:阶段一建立反馈回路,这是核心,需投入不成比例的精力,可参考 references/feedback-loops.md(列出十种构造回路的方法、如何让回路更快更确定、如何提高非确定性 Bug 的复现率,以及无法构造回路时的应对),未建立可信回路前不得进入下一阶段。阶段二运行回路复现,确认症状与用户描述一致、可多次复现(非确定性 Bug 需足够高的复现率),并记录确切症状。阶段三先给出 3–5 个排序假设,每个必须可证伪并写明预测,测试前展示给用户。阶段四插桩,每个探针须对应某一预测,一次只改一个变量;优先调试器/REPL,其次在区分假设的边界打定向日志,日志加唯一前缀如 [DEBUG-a4f2] 便于最后统一清理;性能问题先建基线(计时框架、performance.now()、profiler、查询计划)再做二分。阶段五先写回归测试再修复,但仅在存在正确接缝时;接缝过浅会带来虚假信心,无正确接缝本身就是发现,需记录并上报。阶段六完成前须确认原始复现不再出现、回归测试通过、所有调试日志清除、丢弃原型删除,并在提交/PR 信息中写明最终正确的假设;随后反思什么能预防该 Bug,若涉及架构问题,在修复完成后再向用户提出跟进建议。适用场景:本地调试与修复流程。限制:收费、价格、平台支持等信息暂未提供。