Loop 依据 Ralph Loop 模式组织任务执行,核心流程为「执行 → 验证 → 迭代」,直到质量检查通过并标记为 VERIFIED_DONE。用途集中在需要反复修正直到通过质量门禁的工程任务,如修复全部类型错误、把测试覆盖率提升到指定目标、清理 lint 警告、修复构建错误。
使用方式以命令调用为主,例如 /loop "fix all type errors"、/loop "implement tests until 80% coverage",也可使用 ralph loop "fix lint errors"。执行阶段允许按需进行编辑、写入与运行命令;验证阶段通过 ralph gates 运行质量门禁。若验证失败且未达迭代上限,则迭代计数加一后回到执行阶段;超过上限则报告「Max iterations reached」。
迭代上限按模型区分:Claude(Sonnet/Opus)为 25 次,MiniMax M2.1 为 50 次,MiniMax-lightning 为 100 次。上限由 hooks 自动强制执行。常见循环类型包括修复循环、覆盖率循环、lint 循环与构建循环。
退出条件分三类:成功为质量门禁通过、测试通过、无剩余错误;失败为达到迭代上限并报告遗留问题、请求用户指引;手动退出为用户中断、检测到严重错误或死锁。该模式被描述为所有 Ralph 任务的核心模式,由 /orchestrator 在 Step 5 使用。
限制与反模式:不得超出迭代上限,不得省略验证步骤直接循环,不得忽略失败的测试,也不得在同一错误上反复循环而不检测死锁。资料未提供安装方法、依赖要求、支持平台与收费信息。