AI 编码智能体循环编排引擎 - Ralph Loop (Agent Mode)

通过 exec/process 工具编排 AI 编码智能体的循环工作流，支持 TTY 模式运行 OpenCode、Codex、Claude Code 等交互式 CLI。

基本信息

• 技能名称?Ralph Loop (Agent Mode)
• 中文名称?AI 编码智能体循环编排引擎
• 作者?addozhang
• 分类?专业技能
• 版本?1.1.0
• 标签?ai-agent, coding-automation, cli-orchestration, opencode, codex, claude, goose, pty, workflow-engine, sandbox

使用方法

使用说明
核心用法
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 隔离并行任务，在受控沙箱环境中运行，并始终保留人工审查环节。