用途:把代码库或变更集收敛到“干净”状态——所有测试通过、无关键/重大审查发现。通过有界、证据驱动的“审查→测试→修复”循环反复执行。
主要能力:多轮循环;支持 diff(默认,侧重审查当前改动)与 codebase(审查指定路径集)两种范围;通过 run-automated-tests 运行测试,模式为 fast(默认,仅单元测试)、ci(尽量镜像 CI)、full(含集成/e2e,需显式确认依赖/服务);以最小补丁修复,保持 API 契约;检测停止条件(无进展、环境阻塞、不稳定测试、迭代上限);输出结构化 Repair Loop Report。
使用方式:先做 pre-flight,确认目标路径(默认 .)、范围、完成定义、max_iterations(默认 5)、时间预算与允许动作(默认不改依赖、不联网、不起 Docker/服务、不做大重构,除非用户确认)。随后循环:收集信号→运行测试→制定最小修复计划→应用补丁→重跑相关测试。测试通过且无关键/重大发现即收敛停止。
适用场景:让测试持续变绿、稳定 PR/变更集、镜像 CI 修复失败等。
限制:不安装依赖、不联网、不启动 Docker/服务、不执行破坏性命令,除非显式确认;不通过禁用测试、弱化断言或删除覆盖来“修复”;不做大重构;不改无关仓库;不要求用户在聊天中粘贴密钥。无进展(同一失败重复 2 轮)、环境阻塞、疑似不稳定测试或达迭代上限时停止并给出选项。默认不写报告文件,用户明确要求时才持久化。最终输出 Repair Loop Report(JSON 格式)。