@luc1ferase/ccg-workflow

v1.7.67

Published

24 days ago

Claude-Codex 双模型协作系统 - 智能路由开发工作流

0High
0Medium
0Low

luc1ferase

claude codex multi-model ai collaboration cli workflow

CCG - Claude + Codex Dual-Model Collaboration

Claude Code 编排 Codex + Claude 的双模型协作开发系统。前端任务路由至 Claude（claude-opus-4-6），后端任务路由至 Codex（gpt-5.4），Claude 负责前端实现与编排决策。

安装

npx @luc1ferase/ccg-workflow

安装后本地 CLI 命令仍然可以使用 ccg；同时为了兼容 npx @luc1ferase/ccg-workflow 直跑，也额外暴露了 ccg-workflow 命令别名。

可用于验证发布是否正常：

npx @luc1ferase/ccg-workflow --version
npx @luc1ferase/ccg-workflow menu

要求：Claude Code CLI、Node.js 20+

重要：本项目依赖 [email protected] 和 [email protected]，这些包要求 Node.js >= 20。使用 Node.js 18 会导致 SyntaxError: Invalid regular expression flags 错误。请确保升级到 Node.js 20 或更高版本。

可选：Codex CLI（后端）、Claude CLI（前端）

命令

| 命令 | 说明 | |------|------| | /ccg:workflow | 6 阶段完整工作流 | | /ccg:plan | 多模型协作规划 (Phase 1-2) | | /ccg:execute | 多模型协作执行 (Phase 3-5) | | /ccg:feat | 新功能开发 | | /ccg:frontend | 前端任务 (Claude) | | /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 | 双模型交叉审查 | | /ccg:team-research | Agent Teams 需求 → 约束集 | | /ccg:team-plan | Agent Teams 约束 → 并行计划 | | /ccg:team-exec | Agent Teams 并行实施 | | /ccg:team-review | Agent Teams 双模型审查 |

OPSX 规范驱动（v1.7.52+）

集成 OPSX 架构，把需求变成约束，让 AI 没法自由发挥：

# 初始化 OPSX 环境
/ccg:spec-init

# 研究需求 → 输出约束集
/ccg:spec-research 实现用户认证

# 并行分析 → 零决策计划
/ccg:spec-plan

# 按计划执行
/ccg:spec-impl

# 独立审查（随时可用）
/ccg:spec-review

说明：/ccg:spec-* 命令是 CCG 对 OPSX 的封装，内部调用 /opsx:* 命令。每阶段之间可 /clear，状态存在 openspec/ 目录，不怕上下文爆。

Agent Teams 并行实施（v1.7.60+）

利用 Claude Code Agent Teams 实验特性，spawn 多个 Builder teammates 并行写代码：

# 1. 需求研究 → 约束集（复杂项目推荐，简单项目可跳过）
/ccg:team-research 实现实时协作看板 API

# 2. /clear 后规划 → 零决策并行计划
/ccg:team-plan kanban-api

# 3. /clear 后并行实施 → Builder teammates 并行写代码
/ccg:team-exec

# 4. /clear 后审查 → 双模型交叉审查
/ccg:team-review

前置条件：需手动启用 Agent Teams（settings.json 中设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1）

vs 传统工作流：Team 系列每步 /clear 隔离上下文，通过文件传递状态。Builder 并行实施，适合可拆分为 3+ 独立模块的任务。

规划与执行分离

v1.7.39 新增 /ccg:plan 和 /ccg:execute 命令，将规划与执行解耦：

# 1. 生成实施计划
/ccg:plan 实现用户认证功能

# 2. 审查计划（可修改）
# 计划保存至 .claude/plan/user-auth.md

# 3. 执行计划（新会话也可执行）
/ccg:execute .claude/plan/user-auth.md

配置

目录结构

~/.claude/
├── commands/ccg/       # 斜杠命令
├── agents/ccg/         # 子智能体
├── bin/codeagent-wrapper
└── .ccg/
    ├── config.toml
    └── prompts/{codex,claude}/

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | 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）：

{
  "env": {
    "CODEAGENT_POST_MESSAGE_DELAY": "1",
    "CODEX_TIMEOUT": "7200",
    "BASH_DEFAULT_TIMEOUT_MS": "600000",
    "BASH_MAX_TIMEOUT_MS": "3600000"
  }
}

MCP 配置

代码检索 MCP（二选一）：

ContextWeaver（推荐）- 本地混合搜索，需要硅基流动 API Key（免费）
ace-tool（收费）- Augment 官方，Token 获取：https://augmentcode.com/

辅助工具 MCP（可选）：

Context7 - 获取最新库文档
Playwright - 浏览器自动化/测试
DeepWiki - 知识库查询
Exa - 搜索引擎（需 API Key）

# 配置 MCP
npx @luc1ferase/ccg-workflow menu  # 选择「配置 MCP」

实用工具

npx @luc1ferase/ccg-workflow menu  # 选择「实用工具」

ccusage - Claude Code 用量分析
CCometixLine - 状态栏工具（Git + 用量跟踪）

安装 Claude Code

npx @luc1ferase/ccg-workflow menu  # 选择「安装 Claude Code」

支持多种安装方式：npm、homebrew、curl、powershell、cmd

更新 / 卸载

# 更新
npx @luc1ferase/ccg-workflow@latest          # npx 用户
npm install -g @luc1ferase/ccg-workflow@latest  # npm 全局用户

# 卸载
npx @luc1ferase/ccg-workflow  # 选择 "卸载工作流"
npm uninstall -g @luc1ferase/ccg-workflow  # npm 全局用户需额外执行

已知问题

Codex CLI 0.80.0 进程不退出

--json 模式下 Codex 完成输出后进程不会自动退出。

解决：设置 CODEAGENT_POST_MESSAGE_DELAY=1

架构

Claude Code (编排)
       │
   ┌───┴───┐
   ↓       ↓
Codex   Claude
(后端)   (前端)
   │       │
   └───┬───┘
       ↓
  Unified Patch

外部模型无写入权限，仅返回 Patch，由 Claude 审核后应用。

致谢

cexll/myclaude - codeagent-wrapper
UfoMiao/zcf - Git 工具
GudaStudio/skills - 路由设计
ace-tool - MCP 工具

Star History

License

MIT

v1.7.67 | Issues