Codex Agent Skill 用于把 Codex CLI 当作受管编码代理来操作,覆盖从 worktree 准备到 PR 合并的流程。
用途
- 在隔离的 Git worktree 和分支中运行 Codex 完成编码任务,避免与其它工作冲突。
- 通过 tmux 会话在任务进行中调整方向,而不必终止并重启代理。
- 跟踪任务状态、执行质量门禁、进行跨模型代码审查,并管理重试与清理。
前置条件
- 安装并验证 Codex CLI:codex --version;安装命令为 npm i -g @openai/codex 或 brew install codex。
- 完整工作流要求使用 tmux,可用 tmux -V 验证。
主要能力
- 快速模式:使用 codex exec 进行非交互式一次性执行,适合小修复、单文件修改或分析;可配合 --full-auto、-c "model_reasoning_effort=high" 等参数。
- 完整模式:为功能开发、缺陷修复和重构提供从任务到合并 PR 的工作流,包括创建 worktree、在 tmux 中启动 Codex、日志记录、任务注册、监控与中途 Steering、Definition of Done 检查、多模型代码审查、通知与清理。
- 自适应超时:不建议对 Codex 任务使用硬超时,而是后台执行并周期性轮询;文档给出每 5 分钟轮询、12 小时无新输出再询问用户的策略。
- 智能重试:根据失败类型(上下文溢出、方向错误、信息缺失、CI 失败、构建失败)调整提示词,最多重试 3 次,之后升级给人工。
- 并行执行:可在不同 worktree 上同时运行多个 Codex 任务,并通过日志文件查看进度。
- 推理强度与沙箱模式:支持 low、medium、high 的 model_reasoning_effort;沙箱模式包括 read-only、workspace-write/--full-auto、danger-full-access。
使用方式
- 快速任务通过 exec 命令执行,例如 codex exec --full-auto 'fix the typo in README.md'。
- 完整流程按步骤执行:创建 worktree 与分支、安装依赖、启动 tmux 会话、在启动 Codex 前用 pipe-pane 记录日志、用 send-keys 启动 Codex、注册任务、监控与 Steering、检查 DoD、跨模型审查、通知、合并后清理。
- 运行在容器或沙箱环境时,可使用 --dangerously-bypass-approvals-and-sandbox 跳过提示与沙箱。
适用场景
- 小范围修复与代码分析(快速模式)。
- 功能实现、缺陷修复、重构等多步骤编码任务(完整模式)。
- 需要中途调整方向、长期运行、并行多任务或跨模型审查的开发流程。
限制
- 完整工作流依赖 tmux;快速模式需要 Codex CLI。
- 快速模式的会话输出仅保存在内存中,OpenClaw 重启会丢失,关键任务建议使用完整模式配合日志文件。
- tmux capture-pane 仅保留约 2000 行回滚,长任务应读取日志文件。
- 最多重试 3 次,超过后需要人工介入。
- 文档未提供具体的收费、价格、平台覆盖或效果保证信息,暂未提供。