用途:为难以定位的 bug 和性能回退提供有纪律的诊断流程。仅在明确说明理由时可跳过阶段。
主要能力:先探索 codebase——若存在 GLOSSARY.md 则读取,建立相关模块的心智模型,并检查受影响区域的 ADRs。流程分六个阶段:构建 feedback loop、复现并最小化、形成 3-5 个可证伪的排序假设、按预测插桩、修复并写 regression test、清理。
Feedback loop 是关键:优先通过 failing test、curl/HTTP script、CLI fixture 对比、Playwright/Puppeteer、replay trace、throwaway harness、property/fuzz、bisection、differential loop,最后才用 scripts/hitl-loop.template.sh 做 HITL。loop 需 red-capable、确定性、秒级、可无人值守运行;非确定性 bug 以提高复现率为目标。
使用方式:运行 loop 看到变红,确认失败模式与用户描述一致,再最小化复现。测试前把排序假设展示给用户。插桩时一次只改一个变量,debug log 加唯一前缀如 [DEBUG-a4f2]。性能回退先建立 baseline measurement,再 bisect。
限制与注意:展示命令、输出和捕获物前先脱敏,用 <REDACTED> 替换 secret;build loop 针对 env vars 进行;捕获的 artifacts 含 auth headers 时只引用携带 signal 的行。若无法构建 loop,应停下并说明尝试过什么,向用户请求环境访问、经脱敏的捕获物或临时插桩许可,不要继续猜测。没有 red-capable command 就不进入 Phase 2。若不存在 correct seam,需记录并标记。完成前须确认原始 repro 不再复现、regression test 通过、移除所有 [DEBUG-...] 插桩、删除 throwaway prototypes,并把正确 hypothesis 写进 commit/PR message。其他收费、价格、平台等信息资料未提供。