用途:Ralph 循环模式用于自主的“从问题到合并 PR”工作流,为运行中的代理提供完成信号、进度跟踪和迭代方式的规范指导。
主要能力:定义两种完成信号,需输出精确 XML 标签供 shell 脚本检测:<promise>DONE</promise> 表示任务完成并成功退出;<promise>BLOCKED</promise> 表示无法继续、需人工介入。Ralph 通过 Git HEAD(提交)与 PR 状态(评审、CI 状态)监控“无进展”熔断器,因此需频繁提交以体现进展,避免长时间无提交。循环内可访问 /spec、/architect、/build、/refactor、/update-docs、/pr,以及用于并行代理委派的 Task 工具、Sentry、PostHog、GitHub MCP 和所有已配置的钩子与技能。
使用方式:委派实现可用 Codex CLI,例如 codex exec --full-auto "Implement [feature]. Follow pattern in [ref file]." --output-last-message /tmp/codex-out.md 2>/dev/null;并行工作可用 Task({ subagent_type: "general-purpose", prompt: "..." })。处理 CI 失败:用 gh run view --log-failed 获取日志,分析失败,修复并推送,等待自动重跑。处理评审反馈:用 gh pr view --comments 获取评论,区分关键与风格性反馈,优先处理关键项,推送更改,并通过提交信息或 PR 评论回复评审者。
适用场景:需要自主推进问题修复并产出合并 PR 的自动化开发流程。
限制与注意:输出 BLOCKED 的情形包括缺少必需凭据或 API 密钥、需求含糊需人工澄清、约束冲突无明确解法、外部依赖不可用、无法解决的权限问题;标签后应附简短说明。反模式包括:不要在同一失败测试上无限循环、不要为显示进展而提交空提交、不要忽视评审反馈、不要跳过结尾的 /codify-learning(Ralph 会自动执行)。