CCCC — Claude Code × Codex 协作引擎

版本 0.1.23  |  代号 CCCC  |  协议 MIT

English

---

CCCC（cc-codex-collaborate）是一个 Claude Code Skill，让 Claude Code 和 Codex 在安全的、基于里程碑的工程循环中协作。

Claude Code 负责发现项目、制定规划、实现里程碑、修复问题、管理状态。Codex 作为独立只读审阅者，挑战初始规划、审阅每个里程碑、建议安全的下一步。遇到歧义、敏感操作、真实密钥、生产变更、资金操作或阈值失败时，必须由人类决策。

---

快速开始

/cccc setup             首次配置
/cccc "你的任务描述"      启动协作流程
/cccc continue          继续工作（启用 loop + 恢复 workflow）
/cccc status            查看当前状态

它做什么

把一次编码任务变成可控的协作循环：

1. 检测语言 — 识别用户主语言，全程使用该语言交互。
2. 发现项目 — 规划前先理解已有代码和架构。
3. 构建上下文 — 在 docs/cccc 下生成项目上下文文件。
4. 制定路线 — 生成 roadmap 与 milestone backlog。
5. 自审规划 — Claude Code 先做规划自审（planning self-review）。
6. 对抗审核 — Codex 再做推翻式规划审核（adversarial plan review）。
7. 安全启动 — 规划安全并通过后才进入实现阶段。
8. 逐个实现 — 每次只实现一个 milestone。
9. 独立审阅 — Codex 以只读模式审阅当前 diff。
10. 修复迭代 — 修复 → 再审阅 → 通过后进入下一 milestone，直到完成或触发暂停。

设计原则

原则	说明
Claude Code 主导	Claude Code 是唯一的编排者和实现者
Codex 只审不写	Codex 只读、推翻式审阅，不修改代码
人类兜底	敏感决策必须由人类确认
先理解再规划	没有项目理解，不做项目规划
上下文先行	没有 context-bundle.md，不让 Codex 规划
安全闸门	遇到密钥/资金/生产/破坏性操作，不能自动继续

Review Gate 规则

必需的 review gate 可以是以下任一形式：

• Codex 审阅
• 批量 Codex 审阅
• 缓存的 Codex pass
• 允许的 Claude adversarial bypass review（标记为 lower assurance）

关键约束：

• 没有 required review gate 通过，不允许实现 / 标记完成 / 标记任务完成
• Critical / secrets / production / wallet / real-money / destructive 操作不能静默绕过 Codex 或人工审阅
• Codex pass 和 Claude bypass pass 是不同的保证级别（bypass ≠ pass）

命令参考

所有命令都有完整形式 /cc-codex-collaborate 和短别名 /cccc。

主命令

命令	作用
/cccc setup	交互式配置向导（首次使用入口）
/cccc "任务描述"	启动完整协作流程
/cccc continue	启用 loop + 继续/恢复 workflow
/cccc pause	禁用 loop 自动化
/cccc status	聚合状态（workflow + gates + budget）
/cccc update	安全迁移工作区（升级后同步）
/cccc doctor	诊断安装/配置/hooks/Codex
/cccc reset	重置状态机（从文档重新推断进度）

/cccc status --gates 显示详细 gate 细节。/cccc update --force 强制同步。/cccc doctor --fix 执行安全修复，--trace 显示事件，--codex 检查 Codex CLI，--rebuild-context 重建上下文。

docs pipeline

命令	作用
/cccc docs sync	检测并同步 docs/cccc 文档变化
/cccc docs sync --inbox	增量发现 inbox 文档变化
/cccc docs diff	只查看文档变化（不修改状态）
/cccc docs ingest	导入外部讨论文档到 inbox
/cccc docs curate	提炼 raw docs 中的工程内容到 canonical docs
/cccc docs distill	从所有来源重建项目状态
/cccc docs replan	文档变化后重新规划

review pipeline

命令	作用
/cccc review budget	查看 Codex 预算、策略、缓存、checkpoint
/cccc review now	强制立即 Codex review
/cccc review bypass	管理 Codex bypass（Codex 不可用时）
/cccc review recheck	Codex 恢复后重新检查 bypassed gates
/cccc review checkpoint	管理 Codex-approved checkpoint

dev 命令

命令	作用
/cccc dev smoke	开发者自测

兼容 alias

以下旧命令仍然可用，映射到新结构：

旧命令	映射到
/cccc resume / /cccc-loop-start	/cccc continue
/cccc-loop-status	/cccc status
/cccc-loop-stop	/cccc pause
/cccc sync-docs	/cccc docs sync
/cccc diff-docs	/cccc docs diff
/cccc ingest-docs	/cccc docs ingest
/cccc sync-inbox	/cccc docs sync --inbox
/cccc curate-docs	/cccc docs curate
/cccc distill-project	/cccc docs distill
/cccc replan	/cccc docs replan
/cccc bypass-codex	/cccc review bypass
/cccc codex-recheck	/cccc review recheck
/cccc codex-budget	/cccc review budget
/cccc review-now	/cccc review now
/cccc checkpoint	/cccc review checkpoint
/cccc force-update	/cccc update --force
/cccc gates	/cccc status --gates
/cccc repair	/cccc doctor --fix
/cccc trace	/cccc doctor --trace
/cccc codex-check	/cccc doctor --codex
/cccc rebuild-context	/cccc doctor --rebuild-context
/cccc dev-smoke	/cccc dev smoke

首次使用

/cccc setup

配置预设：

预设	适用场景	特点
A. 快速配置	大多数项目（推荐）	3 轮 review，1200 diff 行，P1 阻塞
B. 严格配置	高风险项目	4 轮 review，600 diff 行，P2 也阻塞
C. 自定义	逐项配置	语言、模式、粒度、review 阈值、自动化

config.json 与 state.json

文件	用途	何时修改
docs/cccc/config.json	项目级配置：模式、阈值、语言、安全策略、自动化	setup 时或手动编辑
docs/cccc/state.json	运行时状态：当前 milestone、status、review 轮次、pause reason	每次运行自动更新

Hook 行为

hooks 默认不启用。需要显式执行：

/cccc continue

Stop hook 只负责"未完成则继续"的监督，绝不放行危险操作。

禁用自动续跑：

/cccc pause

Codex 不可用与 Bypass 模式

在 setup 中选择 Codex 不可用时的策略：

• 严格暂停 — 最安全，等待 Codex 恢复
• 允许一次性 bypass — 由 Claude Code 做推翻式 review（推荐）
• 允许低/中风险自动 bypass — 高风险仍暂停

Bypass 不等于 Codex pass。Bypass 会生成 lower-assurance review artifact，gate 状态标记为 bypassed。

/cccc review bypass status    # 查看状态
/cccc review bypass once      # 请求一次性 bypass
/cccc review bypass off       # 关闭 bypass
/cccc review recheck          # Codex 恢复后重新检查

混杂文档提炼

推荐流程：

1. 把混杂文档放入：docs/cccc/inbox/gpt-discussions/
2. 运行：/cccc docs sync --inbox
3. 运行：/cccc docs curate
4. 确认哪些内容进入 canonical docs
5. 如果架构或 roadmap 发生变化：/cccc docs replan
6. 然后执行：/cccc "你的任务"

运行时工作区

docs/cccc 在 setup 时自动生成，无需手动创建。

docs/cccc/
  config.json              # 项目配置
  state.json               # 运行状态
  project-brief.md         # 项目简报
  project-map.md           # 项目地图
  current-state.md         # 当前状态快照
  architecture.md          # 架构说明
  test-strategy.md         # 测试策略
  roadmap.md               # 路线图
  milestone-backlog.md     # 里程碑待办
  decision-log.md          # 决策日志
  risk-register.md         # 风险登记
  open-questions.md        # 待解决问题
  context-bundle.md        # 上下文摘要（Codex 审阅的输入）
  reviews/                 # 审阅记录
  logs/                    # 运行日志
  runtime/                 # 运行时临时文件
  backups/                 # 配置备份

安装

将 skill 目录安装到目标项目：

.claude/skills/cc-codex-collaborate/

升级

/cccc update

追问设计

需要澄清时，采用 brainstorming 式追问：说明原因 → 给出 2–5 个选项 → 推荐默认 → 记录决策。

推荐 .gitignore

docs/cccc/logs/
docs/cccc/runtime/
docs/cccc/backups/

---

许可证

MIT