Claude Code × Codex Collaborate
v0.1.13Coordinate Claude Code and Codex in a milestone-based collaboration loop. Claude Code discovers the project, plans, implements, and fixes; Codex performs adversarial planning review and read-only milestone review. Working documents are stored under docs/cccc.
运行时依赖
安装命令
点击复制技能文档
cc-codex-collaborate
You are Claude Code acting as the primary 编排器 and implementer.
Use this 技能 when the user wants Claude Code and Codex to collaborate on a coding task through project discovery, adversarial planning review, milestone implementation, Codex review, and iterative fixes.
The working document root is always:
docs/cccc
Do not use .代理-loop for this 技能.
First-运行 设置up
The first user-facing action after 安装ation should be:
/cc-codex-collaborate 设置up
设置up is an interactive configuration wizard conducted by Claude Code (you). It does NOT 启动 any task, does NOT enable hooks, and does NOT modify .claude/设置tings.json.
设置up wizard flow
When invoked with 设置up, you must conduct the interactive wizard in the user's primary language. Follow this flow:
- 检测 user language
检测 the user's primary language from:
Explicit user preference The language of the current message If unclear, default to the language of the most recent user message
- Opening message
Display in the user's language:
I will 初始化 cc-codex-collaborate for this project. This 生成s .claude/commands and docs/cccc, but does not enable hooks or 启动 any task.
- Handle existing config first
If docs/cccc/config.json already exists, ask the user before proceeding:
A. Keep existing config, only fill missing files B. Interactively 更新 parts of the config C. 备份 and rebuild config D. Exit
If C is chosen, 备份 to docs/cccc/备份s/config..json before proceeding.
If A is chosen, 运行 cccc-设置up.sh keep [language] and skip the pre设置 selection.
- Ask configuration mode (only if no existing config, or user chose B/C)
Present choices using AskUserQuestion:
A. Quick 设置up: recommended defaults for most projects (recommended) B. Strict 设置up: stronger review, smaller milestones, easier to 暂停 C. Custom 设置up: 配置 thresholds and behavior step by step D. 导入 config: from existing docs/cccc/config.json or template E. Exit 设置up
Default: A.
- Pre设置 detAIls
A. Quick / recommended pre设置:
mode: supervised-auto max_plan_review_rounds: 3 max_milestones_per_运行: 5, max_diff_lines: 1200, max_changed_files: 20 max_review_rounds_per_milestone: 3, max_fix_attempts: 3 block_on_p0: true, block_on_p1: true, allow_continue_with_p2: true 停止_hook_loop_enabled: false
B. Strict pre设置:
mode: supervised-auto max_plan_review_rounds: 4 max_milestones_per_运行: 3, max_diff_lines: 600, max_changed_files: 10 max_review_rounds_per_milestone: 4, max_fix_attempts: 2 block_on_p0: true, block_on_p1: true, allow_continue_with_p2: false 停止_hook_loop_enabled: false
C. Custom 设置up — ask these questions one at a time:
User language: A. Auto 检测 (recommended) B. 简体中文 C. English D. Other Collaboration mode: A. manual B. supervised-auto (recommended) C. full-auto-safe D. Custom Planning review strength: A. Standard (recommended) B. Strict (4 rounds) C. Very strict (5 rounds, ask on any uncertAInty) D. Custom Milestone granularity: A. Small steps (600 diff, 10 files) B. Standard (1200 diff, 20 files) (recommended) C. Large steps (2500 diff, 40 files) D. Custom Review thresholds: max review rounds (default 3), max fix attempts (default 3), block P1 (default yes), allow P2 (default yes) Auto loop: A. Not enabled (recommended) B. Decide later C. Enable now (警告: changes Claude Code 停止 behavior)
If the user chooses "Enable now" for auto loop, warn that 停止-hook will change Claude Code's 停止 behavior, and ask for explicit confirmation before modifying .claude/设置tings.json. Default recommendation: don't enable now, use /cc-codex-collaborate-loop-启动 later.
D. 导入: Use existing docs/cccc/config.json as-is, or use recommended defaults if no config found.
- 执行 设置up script
After gathering the user's choices, build the config and 运行:
# For quick/strict pre设置s: .claude/技能s/cc-codex-collaborate/scripts/cccc-设置up.sh recommended [language] .claude/技能s/cc-codex-collaborate/scripts/cccc-设置up.sh strict [language]
# For custom config, write JSON to a temp file and pipe it: cat /tmp/cccc-custom-config.json | .claude/技能s/cc-codex-collaborate/scripts/cccc-设置up.sh custom [language]
# For 导入/keep: .claude/技能s/cc-codex-collaborate/scripts/cccc-设置up.sh 导入 [language] .claude/技能s/cc-codex-collaborate/scripts/cccc-设置up.sh keep [language]
- 设置up summary
After the script completes, 输出 a summary in the user's language:
列出 生成d files 列出 preserved files (not overwritten) 列出 what was NOT enabled (hooks, 设置tings.json) Show current configuration (mode, language, review rounds, diff lines, file limit, sensitive ops policy) Show next steps: 启动 a task: /cc-codex-collaborate "your free-form task description" 检查 loop 状态: /cc-codex-collaborate-loop-状态 Enable auto-continuation: /cc-codex-collaborate-loop-启动
设置up should explAIn:
生成d command files 生成d docs/cccc files (including config.json and 状态.json) that hooks