Codex Bridge
A Claude Code skill that bridges to Codex CLI, externalizing context into structured bundles for explicit, verifiable collaboration.
yaohui325 · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add yaohui325/codex-bridgeAbout this skill
codex-bridge
显式触发的 Claude Code → Codex CLI 桥接 skill。把对话上下文 / plan / 相关文件 / 项目约定外化为 bundle 目录,调
codex exec拿回结构化 JSON 响应 + Claude Code 用 jq 后处理校验。
核心命题:Claude Code 调 Codex 时,上下文是显性的、结构化的、可机械校验的,而不是塞到 prompt 字符串里靠 LLM 猜。
这个 skill 解决什么问题
当 Claude Code 通过 Bash 直接调用 codex exec 时,只有 prompt 字符串能传给 Codex。结果:
- 当前对话讨论过的方向、ruled-out 的方案 → 丢失
- plan / 主件代码引用但没 inline 的文件 → Codex 看不到
- 项目约定(CLAUDE.md / AGENTS.md) → 丢失
- "我已经试过 X / 确认 Y" 等隐性信息 → 丢失
本 skill 把"显性外化上下文"变成强制工作流——Claude Code 调 Codex 前必须先把所有相关信息打包成一个磁盘 bundle,调 codex exec 拿回结构化 JSON 响应。
角色分工(v1.2 起,根本设计原则)
| 角色 | 定位 | 主要职责 |
|---|---|---|
| Claude Code(主) | 全面把控者 + 聪明规划者 | 业务规划、工作流编排、bundle 打包、用户接口、最终决策("不盲目吸收"discipline) |
| Codex(辅) | 细节补盲者 | 补 Claude Code 在 schema 字段 / 文件引用 / 边界 case / 测试覆盖 / 文档一致性 / 隐藏假设等细节维度的盲点 |
Codex 的副职:发现业务规划问题也欢迎,但不是主职——Claude Code 在战略上通常更强(它有完整对话上下文),Codex 的最大价值在它单干会漏的细节。
详见 SKILL.md "角色分工" section。
4 个场景
| 场景 | 用途 | sandbox |
|---|---|---|
plan-review | 让 Codex 审计 plan / 设计 / 代码 | read-only |
codify | 让 Codex 写代码完成任务 | workspace-write |
review-iteration | 基于 Claude review 让 Codex 修改(Round 2,硬上限) | workspace-write |
verification-round (v1.1) | 验证 Claude Code 从主轮 finding 提取的 patterns 和 candidates | read-only |
Quick start
安装
git clone <this-repo-url> /tmp/codex-bridge
cd /tmp/codex-bridge
./install.sh
会自动:
- 检查依赖(
jq、bash 4+、codexCLI) - 软链到
~/.claude/skills/codex-bridge - 验证 Claude Code 能识别 skill
使用
在 Claude Code 对话里说:
让 Codex 审一下这个 plan
或显式 slash:
/codex-bridge
skill 自动接管,按 SKILL.md 强制执行清单走 12 步流程(含 v1.1 Pattern Extraction + Lateral Verification)。
Skill 激活情境下的隐式触发(v1.2 关键规则)
⚠️ 重要:一旦用户激活了 skill(通过自然语言触发词或 /codex-bridge),在那个用户任务里 Claude Code 写完任何 plan 都必须先用 plan-review 让 Codex 审一遍,综合后才呈现给用户。
这不是无条件"自动触发"——skill 是