SuperAPI AI 工具集

codex-skill

编程与开发

查看项目

更新于 11-02 02:29

技能介绍

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 次,超过后需要人工介入。
  • 文档未提供具体的收费、价格、平台覆盖或效果保证信息,暂未提供。