SuperAPI AI 工具集

codex-collab

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:让 Claude Code 与 OpenAI Codex CLI 协作完成编码任务。Claude 负责架构设计与全局把控,Codex 负责代码生成细节和独立审查,通过两条独立推理路径交叉验证,暴露单一视角的盲区。

前置要求:Python 3.12+;Codex CLI 已安装且 codex 命令可用(版本 >= v0.61.0)。

主要能力与工作流:需求分析(让 codex 补充边界情况、实施计划与风险);Plan 审查(codex 运行在独立进程,prompt 必须内嵌完整 plan 内容);代码原型(要求仅输出 unified diff patch);代码审查(编码完成后立即执行);对 codex 建议保持独立判断,可继续争辩。

调用方式:通过内置脚本 scripts/codex_exec.py 调用,命令为:python <skill-dir>/scripts/codex_exec.py --prompt "你的指令" --cd /path/to/repo [--sandbox read-only] [--session-id <uuid>] [--all-messages]。参数还包括 --model、--profile、--yolo、--image,均按需使用。

会话管理:每次成功调用返回 session_id,首次调用不传 --session-id,后续传入以延续上下文;切换不相关任务时开启新会话。

安全约束:默认且推荐 --sandbox read-only,严禁 codex 实际修改代码,需要代码时只让其给 unified diff patch。返回值 JSON 形式为 {"success": true, "session_id": "uuid-string", "agent_messages": "codex 的回复"} 或 {"success": false, "error": "错误描述"},每次检查 success 字段。

代码审查:通过 scripts/codex_review.py 调用 codex review,自动过滤工具日志,仅返回摘要与 Full review comments,参考 references/review_guidelines.md。常用命令:python <skill-dir>/scripts/codex_review.py --uncommitted;可附加自定义要求,或用 --base main、--commit <sha>。该方式不返回 session_id、不支持多轮,需多轮讨论时改用 codex_exec.py。codex review 通常需 2-5 分钟,Bash timeout 建议设为 300000。

限制:脚本路径相对于 SKILL.md 所在目录;--cd 目录必须存在,否则静默失败;错误可能来自 codex CLI 未安装、API key 未配置或网络超时;session_id 获取失败时直接开新会话,不重试同一会话。具体触发词与场景、评审细节以资料所述为准,未提供的收费、价格等信息暂未提供。