Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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-bridge

About 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 和 candidatesread-only

Quick start

安装

git clone <this-repo-url> /tmp/codex-bridge
cd /tmp/codex-bridge
./install.sh

会自动:

  1. 检查依赖(jq、bash 4+、codex CLI)
  2. 软链到 ~/.claude/skills/codex-bridge
  3. 验证 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 是