用途：ralph-loop 是面向 Codex 的 ralph-loop 命令，用于按迭代方式推进任务，支持两种执行引擎。
主要能力：默认 compat 引擎保留本地状态语义，需手动执行 --next 推进；可选 open 引擎委托外部 open-ralph-wiggum CLI 实现自动迭代。命令名统一为 ralph-loop，默认状态文件格式为 .claude/ralph-loop.local.md。
使用方式：脚本路径为 scripts/ralph-loop.ps1。先确定 CODEX_HOME，再拼接脚本路径。启动本地 compat 循环：powershell -ExecutionPolicy Bypass -File $script Build a todo API --max-iterations 20 --completion-promise DONE；手动进入下一轮：powershell -ExecutionPolicy Bypass -File $script --next；查看状态：powershell -ExecutionPolicy Bypass -File $script --status；强制以新提示重启：powershell -ExecutionPolicy Bypass -File $script New prompt --max-iterations 10 --force；使用 open 后端：powershell -ExecutionPolicy Bypass -File $script --engine open Build a todo API --max-iterations 20 --completion-promise DONE，默认 --agent codex 与 --no-commit。
适用场景：在 /vibe 路由会话中作为直接执行工具使用，不强制多智能体编排，命令名稳定便于统一记忆与调用。
限制：compat 模式达到 max_iterations 后会自动删除本地状态文件，完成承诺记录在本地状态中；open 模式不支持 --next、--force、--state-file、--stop，由外部 ralph CLI 语义管理；open 引擎与活跃的 XL 团队编排互斥。其他平台、收费与效果信息暂未提供。