SuperAPI AI 工具集

collaborate-with-codex

编程与开发

查看项目

更新于 10-24 16:17

技能介绍

该技能用于协调 Claude Code 与全局配置的 Codex MCP 服务器,目标是让两者在软件工作中可靠协作。整体角色划分是非对称的:Claude 负责澄清需求、识别约束、定义验收标准并做最终验收;Codex 负责实现有边界的改动并运行相关检查。核心工具是 codex 服务器提供的 mcp__codex__codex(启动任务并返回 threadId)与 mcp__codex__codex-reply(用同一 threadId 继续任务)。

主要能力与使用方式:

一、是否委派。满足以下任一条件时使用 Codex:用户明确要求 Codex 或跨模型协作;改动复杂、高风险或跨多个文件/子系统;任务涉及困难缺陷、迁移、重构、安全审查、性能工作或不熟悉的代码;独立实现、诊断或第二意见能实质降低风险;任务有客观验收标准且 Codex 能运行有意义的验证。仅为重复劳动、解释、琐碎编辑、格式化和低风险机械改动则直接处理。

二、可用性检查。若工具被延迟加载,用工具搜索发现;若不可用,只检查 MCP 连接而不修改配置,并如实告知用户哪些能力不可用,不得悄悄改用 shell 调用 Codex。

三、建立基线。委派前在 git 仓库中记录 git status --short 与当前 HEAD,并标注已有未提交改动;非 git 目录则记录范围内文件的大小与修改时间。验证命令若成本低,先运行一次,以区分原有失败与回归。

四、任务包。需向 Codex 提供自包含信息:目标与用户可见结果、验收标准、项目绝对路径、范围内外文件或行为、仓库指令与架构约束、已知症状与复现步骤、日志或失败测试、必须运行的验证命令、禁止动作(提交、推送、发布、删除数据、改依赖、大范围重写等),以及期望返回内容(改动文件、验证结果、未决风险、简要总结)。长时间运行的任务还应要求 Codex 在 PROGRESS.md 中逐里程碑追加一行进度。

五、控制委派规模。Codex MCP 调用是同步的,调用期间 Claude 无法行动或答复用户,因此单次调用建议约十分钟内完成;更大工作拆成有独立验收标准的里程碑,并用 mcp__codex__codex-reply 在同一线程串联,里程碑之间向用户汇报并重新验证。

六、工作区隔离。仓库中有用户在意的工作时,优先为 Codex 创建独立 git worktree(git worktree add -b codex/<slug> <绝对路径> <base-ref>),并将该绝对路径作为 Codex 的 cwd。注意 Agent 工具的 worktree 隔离不能替代传递 worktree 路径,因为 Codex 是独立进程。

七、后台子代理。预计超过几分钟的委派应放在后台子代理中执行,使其只做“信使”,不得自行实现、编辑或运行验证;需返回原始 threadId、Codex 最终消息,以及运行后的 git status --short 与 git diff --stat。修正轮次应直接从主会话调用 mcp__codex__codex-reply,不再经过子代理。

八、启动参数。cwd 使用 worktree 绝对路径或项目根路径;sandbox 级别与当前 Claude Code 会话权限一致(read-only、workspace-write、danger-full-access),不给 Codex 更宽或更窄的文件系统权限;approval-policy 使用 never,避免阻塞调用等待无人可答的审批;行为限制写在任务包中。

九、失败恢复。调用报错或中断时,可通过最新 ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl 日志找回 threadId,读取实际执行与改动,再用 codex-reply 继续,并如实向用户报告停滞。

十、审查与收尾。审查时对照基线检查实际工作树、改动是否在范围内、逐条验证验收标准、检查正确性/边界/错误处理/安全/兼容性/复杂度,并独立运行验证;发现按 P0(不可继续或发布)、P1(重大正确性、安全、数据丢失或需求失败)、P2(可维护性)分级,只写可执行发现。修正通过同一 threadId 进行,最多两轮。验收通过且无未决 P0/P1 时,由 Claude 在 codex 分支提交并合并(必要时 --no-ff),合并后重新运行验证并移除 worktree。推送、开 PR、发布、部署、打标签、强制操作、丢弃用户未提交改动等仍需用户明确授权。

适用场景:复杂或高风险软件改动、跨文件重构、迁移、疑难缺陷、安全审查、性能优化、需要第二意见的实现与诊断,以及明确要求 Claude 与 Codex 协作的任务。限制与注意事项:不应用来重复劳动或处理低风险机械改动;同一 worktree 同一时刻只能有一个写入者;不得让评审者在没有具体缺陷或需求缺口时重写可用代码;不得把 Codex 的总结当作正确性证明;不得扩大范围做顺带清理;Codex 模型与推理配置除非用户要求或有记录在案的需要,否则不覆盖。