核心用法
Coding Agent 是一种基于 Bash 的后台代理调度技能，允许用户将复杂编码任务委托给 Codex、Claude Code、Pi 或 OpenCode 等 AI 编程代理执行。该技能采用 pty:true 伪终端模式确保交互式 CLI 正常运行，支持前台快速执行和后台长时间任务两种模式。
关键工作流程：
1. 快速单任务：使用 mktemp -d && git init 创建临时 Git 仓库，直接执行 codex exec "prompt"
2. 后台长任务：组合 pty:true + background:true + workdir: 启动守护式代理会话
3. 进程管理：通过 process 工具进行 list/poll/log/write/submit/kill 等全生命周期监控
4. 批量并行：支持同时启动多个 Codex 实例处理多 PR 审查或多 Issue 修复
支持的代理与模式：
- Codex:
exec（一次性执行）、--full-auto（自动批准）、--yolo（无沙箱最快） - Claude Code: 原生终端集成
- Pi: 支持多 provider/model 选择，含 Anthropic 提示缓存
- OpenCode:
opencode run命令
典型场景：
- 新功能/应用构建
- PR 审查（必须克隆到临时目录或使用 git worktree）
- 大规模代码重构
- 多 Issue 并行修复（配合 git worktree）
显著优点
1. 异步非阻塞：后台模式允许长时间编译/测试不阻塞主会话
2. 工作目录隔离：workdir 参数限制代理上下文，防止越界读取敏感文件
3. 并行扩展性：可同时部署多个代理处理批量任务
4. 多代理兼容：统一接口适配 Codex、Claude Code、Pi 等主流工具
5. 精细进程控制：完整的 stdin/stdout 交互能力和会话监控
潜在缺点与局限性
1. Git 依赖：Codex 强制要求 Git 仓库，临时任务需手动 git init
2. PTY 必需性：忘记 pty:true 会导致代理挂起或输出损坏
3. 安全风险：--yolo 模式无沙箱、无审批，可能执行危险操作
4. 资源消耗：并行多代理显著增加 CPU/内存/LLM token 开销
5. 监控复杂度：需主动轮询 process:log 获取进度，非事件驱动
6. 平台限制：依赖特定二进制（claude/codex/opencode/pi）需预装
适合人群
- 需要异步处理耗时构建/测试任务的开发者
- 需批量审查 PR 或并行修复多 Issue 的维护者
- 希望将编码工作委托给专业 AI 代理的工程师
- 熟悉 Git、命令行和进程管理的进阶用户
常规风险
- 路径遍历：代理可能尝试读取工作目录外的敏感文件（如
~/.openclaw/soul.md），需严格使用workdir限制 - 代码执行：
--yolo模式自动执行命令，可能引入恶意依赖或破坏性操作 - 会话泄漏：后台进程未正确清理可能导致资源泄露
- 通知延迟：长任务完成后若未配置
openclaw system event，用户可能等待数分钟才获知结果 - 沙箱逃逸：部分代理模式（尤其
--yolo）绕过标准安全限制