SuperAPI AI 工具集

codex

编程与开发

查看项目

更新于 11-07 17:53

技能介绍

用途 该技能用于在你需要从另一个智能体(Claude Code 或任何可执行 shell 的智能体)中运行 OpenAI Codex CLI 时使用。Codex 是独立的智能体,有自己的工具、沙箱和会话存储。你通过文件与它交流:brief 从 stdin 输入,最终消息通过 -o 输出,会话 id 让你之后可以继续同一对话。

主要能力

  • 启动任务:使用 codex exec 并配合 -m 指定模型、-c model_reasoning_effort 设置推理强度、-s 选择沙箱模式(read-only、workspace-write、danger-full-access)、-C 指定工作根目录、-o 写入最终报告、< brief.md 从文件读取提示,> log.txt 2>&1 保存事件流。
  • 其他有用参数:--output-schema 输出 JSON 形状的最终答案,--json 输出 JSONL 事件流,--add-dir 增加可写目录,--skip-git-repo-check 在 git 之外运行,--ephemeral 用于不可恢复的一次性运行。
  • 后台运行:任务可能耗时数分钟到一小时,应使用后台命令功能或 & 加 wait,不要循环轮询日志,等进程退出后读取 report.md。
  • 继续会话:从日志中提取 session id,用 codex exec resume 续接;resume 没有 -s 或 -C,需先 cd 到相同目录,并重新传入 -m 和推理强度。用 codex exec fork 可从同一状态分支。应记录每个会话 id 及其工作内容。
  • 并行运行 worker:每个 worker 一个范围(包、目录、样本)和独立报告文件;共享背景与各范围拼接成 brief;两个 worker 不得编辑相同文件,共享检出时 brief 需声明只编辑自己的范围、新测试放新文件、忽略其他范围的类型错误、不得 git commit/stash/checkout/reset;更强做法是给每个 worker 独立 worktree。
  • 构建/测试前隔离:只读 brief 不能阻止 Codex 运行构建。在存在未提交工作时,先运行随技能提供的 scripts/isolate.sh 保存补丁和未跟踪文件并创建分离 worktree,然后用 -C 指向该 worktree 运行,brief 中声明不得符号链接到其他工作区、不得在指向仓库的临时目录中构建。完成后用 git diff --binary 取回并在审查后应用。--worktree 是 Codex 管理的 worktree 替代方案,但无法预置未提交更改。
  • 代码审查:codex exec review 支持 --uncommitted、--base <branch> 或 --commit <sha> 运行内置审查;若需带自定义关注点的对抗性审查,用普通 codex exec 配合只读 brief。独立审查应启动新会话而非 resume,且不给它前几轮的历史。
  • 读取结果:读取 report.md,再在其使用的 worktree 中运行 git status / git diff;报告描述意图,diff 才是实际发生的事。自行运行项目检查,不要未经核实转述“所有测试通过”。若运行失败或报告为空,读 log.txt 尾部。向用户传递发现前先验证,并说明哪些已确认。

使用方式 开始前用 codex exec --help、codex exec resume --help、codex debug models 检查已安装版本和可用模型。启动任务示例: D=<scratch dir outside the repo> codex exec -m gpt-6-astra -c model_reasoning_effort="high"
-s danger-full-access -C /path/to/repo
-o "$D/report.md" - < "$D/brief.md" > "$D/log.txt" 2>&1 继续会话示例: id=$(grep -m1 -i 'session id' "$D/log.txt" | awk '{print $NF}') cd /path/to/same/worktree && codex exec resume "$id"
-m gpt-6-astra -c model_reasoning_effort="high"
-o "$D/report-2.md" - < "$D/followup.md" > "$D/log-2.txt" 2>&1

适用场景 跨智能体委派编码任务、并行处理多个代码范围、需要独立审查、需要在存在未提交更改时安全地让 Codex 构建或测试。

限制与失败模式 模型或推理强度低于要求:resume 未传 -m/-c 时回退配置默认值。resume 忽略 -C,编辑错误树:先 cd 到原始根目录。未提交工作丢失:经符号链接构建/清理导致,需从保存的补丁恢复并在下次隔离。worker 编辑了其他 worker 的文件:范围未声明或共享检出,应分离 worktree。报告流畅但无依据:在后续追问中要求说明哪些点来自运行或阅读代码、哪些是推断。