ROS2 Multi-Model Collaborative Development Workflow - Codex (Low-level Control) + Gemini (Upper-layer Application) + Claude (Orchestration)
npm install ccg-ros2-workflow


Claude Code 编排 Codex + Gemini 的多模型协作开发系统。前端任务路由至 Gemini,后端任务路由至 Codex,Claude 负责编排决策和代码审核。
``bash`
npx ccg-workflow
要求:Claude Code CLI、Node.js 20+
> 重要:本项目依赖 ora@9.x 和 string-width@8.x,这些包要求 Node.js >= 20。使用 Node.js 18 会导致 SyntaxError: Invalid regular expression flags 错误。请确保升级到 Node.js 20 或更高版本。
可选:Codex CLI(后端)、Gemini CLI(前端)
| 命令 | 说明 |
|------|------|
| /ccg:workflow | 6 阶段完整工作流 |/ccg:plan
| | 多模型协作规划 (Phase 1-2) |/ccg:execute
| | 多模型协作执行 (Phase 3-5) |/ccg:feat
| | 新功能开发 |/ccg:frontend
| | 前端任务 (Gemini) |/ccg:backend
| | 后端任务 (Codex) |/ccg:analyze
| | 技术分析 |/ccg:debug
| | 问题诊断 |/ccg:optimize
| | 性能优化 |/ccg:test
| | 测试生成 |/ccg:review
| | 代码审查 |/ccg:commit
| | Git 提交 |/ccg:rollback
| | Git 回滚 |/ccg:clean-branches
| | 清理分支 |/ccg:worktree
| | Worktree 管理 |/ccg:init
| | 初始化 CLAUDE.md |/ccg:enhance
| | Prompt 增强 |/ccg:spec-init
| | 初始化 OPSX 环境 |/ccg:spec-research
| | 需求 → 约束集 |/ccg:spec-plan
| | 约束 → 零决策计划 |/ccg:spec-impl
| | 按计划执行 + 归档 |/ccg:spec-review
| | 双模型交叉审查 |
集成 OPSX 架构,把需求变成约束,让 AI 没法自由发挥:
`bash初始化 OPSX 环境
/ccg:spec-init
说明:
/ccg:spec- 命令是 CCG 对 OPSX 的封装,内部调用 /opsx: 命令。每阶段之间可 /clear,状态存在 openspec/ 目录,不怕上下文爆。$3
v1.7.39 新增
/ccg:plan 和 /ccg:execute 命令,将规划与执行解耦:`bash
1. 生成实施计划
/ccg:plan 实现用户认证功能2. 审查计划(可修改)
计划保存至 .claude/plan/user-auth.md
3. 执行计划(新会话也可执行)
/ccg:execute .claude/plan/user-auth.md
`配置
$3
`
~/.claude/
├── commands/ccg/ # 斜杠命令
├── agents/ccg/ # 子智能体
├── bin/codeagent-wrapper
└── .ccg/
├── config.toml
└── prompts/{codex,gemini}/
`$3
| 变量 | 说明 | 默认值 |
|------|------|--------|
|
CODEAGENT_POST_MESSAGE_DELAY | Codex 完成后等待时间(秒) | 5 |
| CODEX_TIMEOUT | codeagent-wrapper 执行超时(秒) | 7200 |
| BASH_DEFAULT_TIMEOUT_MS | Claude Code Bash 默认超时(毫秒) | 120000 |
| BASH_MAX_TIMEOUT_MS | Claude Code Bash 最大超时(毫秒) | 600000 |配置方式(
~/.claude/settings.json):`json
{
"env": {
"CODEAGENT_POST_MESSAGE_DELAY": "1",
"CODEX_TIMEOUT": "7200",
"BASH_DEFAULT_TIMEOUT_MS": "600000",
"BASH_MAX_TIMEOUT_MS": "3600000",
"GEMINI_API_KEY": "your-gemini-api-key",
"GOOGLE_API_KEY": "your-google-api-key"
}
}
`> VSCode 插件用户注意:VSCode 启动的子进程不会继承终端环境变量,必须在
settings.json 中配置 API 密钥,否则 Gemini 会报退出码 41(授权失败)。$3
ace-tool 用于代码检索和 Prompt 增强,安装时可选配置。
Token 获取:https://augmentcode.com/
更新 / 卸载
`bash
更新
npx ccg-workflow@latest # npx 用户
npm install -g ccg-workflow@latest # npm 全局用户卸载
npx ccg-workflow # 选择 "卸载工作流"
npm uninstall -g ccg-workflow # npm 全局用户需额外执行
`已知问题
Codex CLI 0.80.0 进程不退出
--json 模式下 Codex 完成输出后进程不会自动退出。解决:设置
CODEAGENT_POST_MESSAGE_DELAY=1架构
`
Claude Code (编排)
│
┌───┴───┐
↓ ↓
Codex Gemini
(后端) (前端)
│ │
└───┬───┘
↓
Unified Patch
``外部模型无写入权限,仅返回 Patch,由 Claude 审核后应用。
- cexll/myclaude - codeagent-wrapper
- UfoMiao/zcf - Git 工具
- GudaStudio/skills - 路由设计
- ace-tool - MCP 工具

MIT
---
v1.7.52 | Issues