用途:面向难以定位、未解决、间歇性 Bug 和性能回退,提供一套有纪律的诊断循环,仅在明确有理由时才跳过阶段。探索代码库时先读 CONTEXT.md(若存在),并查看相关区域的 ADR。
主要能力:分六个阶段推进。阶段1构建反馈回路,这是核心,其余步骤都依赖它;可用失败测试、curl/HTTP 脚本、CLI 夹具对比、无头浏览器脚本、回放捕获的 trace、一次性最小 harness、属性/模糊测试、二分 harness、差分回路或 HITL 脚本。回路要更快、信号更锐利、更确定;非确定性 Bug 目标是提高复现率而非追求干净复现。若确实无法构建回路,应停下说明并请求环境访问、脱敏捕获物或临时生产插桩许可。阶段1完成标准是存在一条已运行过、能变红、确定、快速、可无人值守运行的命令。阶段2复现并最小化,确认失败模式与用户描述一致,逐步削减输入、调用方、配置、数据和步骤,直到每个剩余元素都承重。阶段3生成3到5个可证伪的排序假设,并先展示给用户。阶段4插桩,每个探针映射到具体预测,一次只改一个变量,优先调试器/REPL,日志加唯一前缀如 [DEBUG-a4f2];性能问题先建立基线再二分。阶段5先写回归测试再修复,但仅当存在正确接缝;若无正确接缝,这本身就是发现。阶段6清理:原复现不再出现、回归测试通过、移除所有调试插桩、删除一次性原型,并在提交信息中写明最终正确的假设。
使用方式与限制:展示命令、输出和捕获物前必须脱敏,用 <REDACTED> 替换密钥,凭据通过环境变量传递,只引用携带信号的日志行。若脱敏后不足以诊断,应说明并询问用户。没有可复现的红色回路就不要进入阶段2。资料未提供具体安装命令、平台、收费或价格信息。