用途：按 Ralph Wiggum 循环方式，为 AI 编码 CLI 生成可直接运行的 Bash 脚本，支持 Codex、Claude Code、OpenCode、Goose 等。
主要能力与流程：脚本按 Ralph playbook 分阶段运行。先由需求落到 specs/*.md，再进入 PLANNING 循环生成/更新 IMPLEMENTATION_PLAN.md（不做实现、不提交），随后进入 BUILDING 循环按计划实现任务、运行测试（backpressure）、更新计划并提交。循环通过 PROMPT.md 与 AGENTS.md 每次迭代重新加载上下文，并借助磁盘上的 plan/specs 保持状态。
必要用法：先收集输入，包括目标/JTBD、所用 CLI、模式（PLANNING、BUILDING 或 BOTH）、完成条件（承诺短语、测试命令或计划哨兵如 STATUS: COMPLETE）、最大迭代次数、沙箱选择与安全策略、需写入 AGENTS.md 的 backpressure 命令，以及是否自动批准标志（Codex 用 --full-auto，Claude Code 用 --dangerously-skip-permissions，需明确询问）。随后准备 PROMPT.md 与 AGENTS.md，分别提供规划与构建两套提示模板并按模式切换。每轮命令示例：Codex 用 codex exec <FLAGS> "$(cat PROMPT.md)"，Claude Code 用 claude <FLAGS> "$(cat PROMPT.md)"，OpenCode 用 opencode run "$(cat PROMPT.md)"，Goose 用 goose run "$(cat PROMPT.md)"。若 CLI 未知，需向用户询问每轮确切命令。最终输出最小循环或带最大迭代与停止条件的受控脚本（需在 git 仓库内运行，日志写入 .ralph/ralph.log）。
适用场景：需要让 AI 编码 CLI 反复规划、实现、测试并提交的开发任务。
限制与安全：使用自动批准标志意味着信任与风险，建议在 docker/e2b/fly 等沙箱中以最小凭据和受限网络运行；可用 Ctrl+C 停止，用 git reset --hard 回退。需求不清时应先补 specs 再进入 BUILDING；计划过期先重新规划；缺少 backpressure 命令应向用户索取并写入 AGENTS.md。