SuperAPI AI 工具集

codex-delegate

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:将一项边界明确的编码任务委托给 OpenAI Codex CLI 作为后台实现者,编排者负责写任务简报、审查产出并自行提交。只发送文本简报,Codex 看不到仓库记忆、聊天历史或共享上下文。

主要能力:捆绑的 relay.mjs 封装 codex exec,捕获运行并写出结构化 result.json,因此编排者只需“运行命令、读取文件”。支持只读模式(--read-only)、隔离审查(--ignore-user-config)、续接同一 Codex 会话(--session <threadId>,仅发增量简报)、无 thread id 时的回退(--resume-last)以及看门狗超时(--timeout 2h,默认关闭)。默认工作区可写沙箱,产物写入临时目录,从不提交。

基本流程:1. 写简报,包含目标、当前状态、要改什么、不要动什么、项目真实的门禁命令(从 CLAUDE.md/AGENTS.md/Makefile 发现)和报告契约;2. 用 node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo 派发;3. 等待完成,result.json 存在且带状态即结束;4. 审查:自行重跑门禁命令、对照简报读 diff、运行可用的守卫技能;5. 门禁通过且 diff 无误后由编排者提交,需要修改则用 --session 发增量简报。

前提:codex --version 可用,否则先执行 npm i -g @openai/codex 并 codex login;确认 PATH 上哪个 codex 生效,旧版本可能缺少本技能依赖的 codex exec --json、-o、exec resume 等标志;位于目标 git 仓库中。

适用场景:有界编码任务的委托实现与审查、按序队列执行、以 --read-only 获取无写风险的对抗性第二意见。

限制:任务太小、codex CLI 未安装或未认证、或只想自己写代码/只需审查时不应使用;设计上运行于 Claude Code,其他编排器属于“已设计但未验证”;沙箱无法可靠写 .git。简报写法、派发选项、审查清单与队列细节见 references/ 下文档。