核心用法
Coding Agent skill 提供了一套完整的框架，用于在 OpenClaw 环境中以编程方式调用主流 AI 编程助手。核心设计遵循 bash-first + PTY 必需 原则：
1. PTY 模式强制启用：所有编码代理均为交互式终端应用，必须通过 pty:true 分配伪终端，否则会出现输出断裂、颜色丢失或进程挂起。
2. 后台进程管理：结合 background:true 与 process 工具（list/poll/log/write/submit/kill），实现非阻塞式长任务运行与实时监控。
3. 多代理支持：涵盖 Codex CLI（OpenAI）、Claude Code（Anthropic）、Kiro CLI（AWS）、OpenCode、Pi Coding Agent 五大主流工具，均提供标准化调用模式。
关键参数与模式
| 场景 | 推荐配置 |
|------|---------|
| 快速一次性任务 | `bash pty:true command:"codex exec 'prompt'"` |
| 长时后台任务 | `+ background:true`，配合 `process action:log` 监控 |
| 自动批准/无沙箱 | Codex 用 `--full-auto`/`--yolo`；Kiro 用 `--trust-all-tools` |
| 并行批量处理 | 多 `background:true` 会话 + `git worktree` 隔离 |
| 复杂需求规划 | 建议用户启用 Kiro `/plan` 代理进行四阶段结构化规划 |
显著优点
- 标准化封装：统一处理 PTY、工作目录隔离、Git 仓库初始化等底层细节
- 进程级可控：完整的生命周期管理（启动→监控→输入→终止）
- 并行扩展：支持同时启动多个代理实例处理批量 PR 审查或 issue 修复
- 安全隔离：通过
workdir限制文件访问范围，配合临时目录/worktree 防止污染主仓库
潜在局限与风险
- PTY 依赖：部分环境可能限制伪终端分配
- Git 前置要求：Codex 强制要求 Git 仓库，需手动
git init或临时目录处理 - 权限边界模糊：
--yolo（无沙箱）与--trust-all-tools可能执行危险操作 - 代理自主性：
--full-auto模式下变更自动提交，需用户明确确认信任边界
适合人群
- 需要自动化代码审查、批量重构、多 issue 并行修复的开发团队
- 追求"编码代理即基础设施"的高级用户
- 已熟悉 Codex/Claude/Kiro 等工具，需在 OpenClaw 中集成工作流的开发者
常规风险提示
⚠️ 严禁在 `~/clawd/` 或 `~/Projects/openclaw/` 中启动代理（会读取敏感配置）
⚠️ PR 审查必须使用临时目录或 worktree，避免在 OpenClaw 自身目录操作
⚠️ 长时间任务建议附加 openclaw gateway wake 通知命令，避免心跳延迟
⚠️ 监控代理输出，避免盲目信任自动批准的变更