通过 exec/process 工具编排 AI 编码智能体的循环工作流，支持 TTY 模式运行 OpenCode、Codex、Claude Code 等交互式 CLI。
说明：
## 核心用法
Ralph Loop 是一种用于编排 AI 编码智能体的自动化工作流技能，指导 OpenClaw 代理使用 `exec` 和 `process` 工具执行循环任务。其核心模式分为两阶段：
1. **PLANNING 循环**：分析需求、创建 `specs/*.md` 规格文档，仅更新 `IMPLEMENTATION_PLAN.md` 而不实施代码
2. **BUILDING 循环**：按优先级执行任务、实施代码、运行测试（backpressure）、更新计划并提交
关键创新在于使用 `exec` 工具的 `pty: true` 参数为交互式 CLI（如 OpenCode、Codex、Claude Code、Goose）提供 TTY 支持，解决传统后台执行导致的挂起问题。配合 `background: true` 和 `process` 工具的 poll/log/kill 动作，实现会话监控、实时日志获取和安全清理。
## 显著优点
– **TTY 兼容性**：解决交互式编码智能体的终端依赖问题，支持主流 AI CLI 工具
– **结构化工作流**：明确的规划/实施分离，通过 `PROMPT.md` 和 `AGENTS.md` 持久化上下文
– **灵活监控**：基于会话 ID 的轮询机制，支持超时控制和并行会话
– **完成检测**：通过 `IMPLEMENTATION_PLAN.md` 中的状态标记（如 `STATUS: COMPLETE`）自动识别任务结束
– **多智能体支持**：可编排 Codex、Claude Code、OpenCode、Goose、Pi 等多种编码代理
## 潜在局限
– **复杂度门槛**：需要理解 exec/process 工具链、PTY 机制及多种 CLI 的特定参数
– **安全风险**：`–full-auto`、`–yolo`、`–dangerously-skip-permissions` 等自动授权标志可能导致未审查代码执行
– **超时调优**：默认 3600 秒超时可能不适合所有任务规模，需人工调整
– **环境依赖**：部分 CLI（如 Codex）要求 git 仓库上下文
– **无内置沙箱**：虽有建议但未强制实施容器隔离，依赖外部沙箱方案
## 适合人群
– 需要批量自动化 AI 编码任务的开发团队
– 熟悉 OpenClaw 工具链和多种 AI CLI 的高级用户
– 追求规划-实施分离、可审计工作流的工程管理者
– 希望并行运行多个编码会话的技术负责人
## 常规风险
– **代码质量风险**：自动授权模式可能引入未经审查的代码变更
– **资源泄漏**：不当的会话管理可能导致僵尸进程或文件句柄泄漏
– **并发冲突**：多会话并行时可能产生 git 冲突或文件竞争
– **凭证暴露**：交互式 CLI 可能意外记录敏感信息到日志文件
– **无限循环**：完成检测失败或提示词设计不当可能导致循环无法终止
建议使用 git worktree 隔离并行任务，在受控沙箱环境中运行，并始终保留人工审查环节。
会员专属
