本文为转载内容，保留原帖观点与结构；如有侵权请联系我处理。

GitHub: GitHub – fengshao1227/ccg-workflow: 多模型协作开发工具集 – 基于 Claude Code CLI，整合 Codex/Gemini 后端能力，提供智能路由、代码审查、Git 工具等 17+ 个命令 觉得好用请留下你的

Star

一句话介绍：Claude Code 编排 Codex + Gemini 三 CLI 协作，智能路由前端→Gemini、后端→Codex，6阶段开发工作流，v1.4.2 新增 Windows MCP 自动修复。

最新版本：v1.4.2 (2026-01-06)

• 

  自动命令包装：Windows 环境下 npx 自动包装为 cmd /c npx

• 

  零手动操作：新用户安装时自动应用修复，无需任何手动配置

• 

  自动备份：修改前自动备份到 ~/.claude/backup/

• 

  诊断工具：新增 npx ccg diagnose-mcp 验证配置

• 

  一键修复：新增 npx ccg fix-mcp 修复现有配置（Windows 用户）

技术来源：从 ZCF 项目 移植完整的跨平台 MCP 配置逻辑

快速开始

30 秒了解

CCG = Claude Code (主导编排) + Codex CLI (后端原型) + Gemini CLI (前端原型)

核心理念：让 Claude 专注于编排决策，把具体代码生成交给专业模型

• 前端任务 → Gemini
• 后端任务 → Codex
• 全栈整合 → Claude

一键安装

# 安装（2 分钟）
npx ccg-workflow

# 选择 "初始化工作流"
# 选择你的 MCP 工具（推荐 ace-tool 开箱即用）
# ✨ Windows 用户：自动应用 MCP 修复
# 安装完成后重启终端

第一个命令

# 在 Claude Code 中执行
/ccg:dev 实现用户登录功能

# 自动执行 6 阶段工作流：
# Phase 0: Prompt 增强 (ace-tool)
# Phase 1: 代码检索 (ace-tool)
# Phase 2: 多模型分析 (Codex ∥ Gemini 并行)
# Phase 3: 原型生成 (前端→Gemini / 后端→Codex)
# Phase 4: 代码实施 (Claude 重构为生产级)
# Phase 5: 审计交付 (Codex ∥ Gemini 交叉验证)

工作流程图

┌─────────────────────────────────────────┐
│   Phase 0: Prompt 增强 (ace-tool)       │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Phase 1: 代码检索 (ace-tool)          │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Phase 2: 多模型分析                    │
│   Codex (后端) ∥ Gemini (前端) 并行     │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Phase 3: 原型生成                      │
│   前端 → Gemini / 后端 → Codex          │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Phase 4: 代码实施 (Claude 主导)       │
│   重构为生产级代码                       │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Phase 5: 审计交付                      │
│   Codex ∥ Gemini 交叉验证               │
└─────────────────────────────────────────┘

这是什么？

基于 @DaiSun 的 Skills 仓库 智能路由理念，整合 cexll/myclaude 多后端调用工具和 UfoMiao/zcf Git 工具集，打造的三模型协作开发系统。

核心特性

特性	说明
智能路由	前端任务→Gemini，后端任务→Codex，全栈整合→Claude
三模型并行	Codex ∥ Gemini 同时调用，交叉验证结果
MCP 自动配置	Windows 自动修复 + ace-tool/auggie 动态选择
6阶段工作流	Prompt增强 → 代码检索 → 分析 → 原型 → 实施 → 审计
18个专家提示词	Codex 6个 + Gemini 6个 + Claude 6个（ROLE_FILE 零 token）
Git 工具集	智能 commit、交互式回滚、分支清理、Worktree 管理
npx 一键安装	无需全局安装，交互式配置菜单
诊断工具	新增 npx ccg diagnose-mcp 和 npx ccg fix-mcp

架构图

┌─────────────────────────────────────────────────────┐
│              Claude Code CLI (主导编排)              │
│          决策、编排、代码实施、质量把控              │
└──────────────┬──────────────────────────────────────┘
               │
       ┌───────┴───────┐
       │               │
       ↓               ↓
┌─────────────┐ ┌─────────────┐
│  Codex CLI  │ │ Gemini CLI  │
│  后端原型   │ │  前端原型   │
│  逻辑算法   │ │  UI 组件    │
└─────────────┘ └─────────────┘

安装指南

前置要求

1. 必需：

   • Claude Code CLI – 主导编排
   • Node.js 16+ 或 Python 3.8+

2. 可选（根据需求）：

   • Codex CLI – 后端任务
   • Gemini CLI – 前端任务

安装步骤

# 1. 运行安装命令
npx ccg-workflow

# 2. 选择 "初始化工作流"

# 3. 选择语言（中文 / English）

# 4. 选择 MCP 工具
#    - ace-tool: 开箱即用，含 Prompt 增强 + 代码检索
#    - auggie: 官方版本，代码检索 + 可选 Prompt 增强
#    - 跳过：手动配置

# 5. 等待安装完成（约 1-2 分钟）
#    ✨ Windows 用户：自动应用 MCP 修复

# 6. 重启终端
#    Mac/Linux: source ~/.zshrc 或 source ~/.bashrc
#    Windows: 重新打开 PowerShell

验证安装

# 检查 codeagent-wrapper 是否可用
codeagent-wrapper --version
# 应该显示类似：codeagent-wrapper v5.4.0

# 诊断 MCP 配置（v1.4.2 新增）
npx ccg diagnose-mcp
# ✅ 检测配置文件是否存在
# ✅ 验证 MCP 服务器配置
# ✅ 检查 Windows 命令包装是否正确

# 查看配置文件
cat ~/.claude/.ccg/config.toml

# 检查已安装的命令
ls ~/.claude/commands/ccg/

命令参考

开发工作流命令

Git 工具命令

项目初始化

CLI 诊断工具（v1.4.2 新增）

# 诊断 MCP 配置问题
npx ccg diagnose-mcp

# 修复 Windows MCP 配置（仅 Windows 用户需要）
npx ccg fix-mcp

使用场景：

• 

  安装后 MCP 不工作

• 

  Windows 用户验证配置正确性

• 

  更新后检查配置兼容性

专家角色系统

核心机制：ROLE_FILE 动态注入

18个专家提示词（Codex 6个 + Gemini 6个 + Claude 6个），采用 零 token 消耗 的 ROLE_FILE 动态注入机制：

• 

  每个命令自动注入对应角色提示词

• 

  不占用主会话 token

• 

  无需手动配置全局提示词

角色映射表

提示词文件结构

~/.claude/.ccg/prompts/          # v1.4.0+ 新位置
├── codex/         # Codex CLI 后端专家（6个）
│   ├── architect.md    # 后端架构师
│   ├── analyzer.md     # 技术分析师
│   ├── debugger.md     # 调试专家
│   ├── optimizer.md    # 性能优化师
│   ├── reviewer.md     # 代码审查员
│   └── tester.md       # 测试工程师
├── gemini/        # Gemini CLI 前端专家（6个）
│   ├── frontend.md     # 前端架构师
│   ├── analyzer.md     # UI/UX 分析师
│   ├── debugger.md     # 前端调试专家
│   ├── optimizer.md    # 前端性能优化
│   ├── reviewer.md     # 代码审查员
│   └── tester.md       # 前端测试工程师
└── claude/        # Claude CLI 全栈专家（6个）
    ├── architect.md    # 全栈架构师
    ├── analyzer.md     # 系统分析师
    ├── debugger.md     # 全栈调试专家
    ├── optimizer.md    # 系统优化师
    ├── reviewer.md     # 高级审查员
    └── tester.md       # 集成测试工程师

常见问题

npx ccg-workflow@latest init
# 安装时自动应用 Windows 修复

# 诊断问题
npx ccg diagnose-mcp

# 一键修复
npx ccg fix-mcp

// 修复前（不工作）
{
  "command": "npx",
  "args": ["-y", "ace-tool@latest"]
}

// 修复后（v1.4.2 自动应用）
{
  "command": "cmd",
  "args": ["/c", "npx", "-y", "ace-tool@latest"]
}

# 检查配置是否正确
cat ~/.claude.json
# 应该看到 "command": "cmd", "args": ["/c", "npx", ...]

npx ccg-workflow
# 选择 "更新工作流"

# 编辑 ~/.claude/.ccg/config.toml
[mcp]
provider = "ace-tool"  # 或 "auggie"

ROLE_FILE: ~/.claude/prompts/ccg/codex/architect.md

# 重启终端或执行
source ~/.zshrc
# 或
source ~/.bashrc

# 重新打开 PowerShell
# 或手动添加到环境变量：
# %USERPROFILE%\.claude\bin

npx ccg-workflow
# 选择 "卸载工作流"

[mcp.tools]
prompt_enhance_auggie = "mcp__auggie__enhance_prompt"  # 填入配置的工具名

鸣谢

感谢以下开源项目的贡献：

• cexll/myclaude – codeagent-wrapper 多后端调用工具的 Go 代码来源，以及 /ccg:code、/ccg:debug、/ccg:test、/ccg:bugfix、/ccg:think、/ccg:optimize 命令的设计参考
• UfoMiao/zcf – Git 工具（commit、rollback、clean-branches、worktree）和项目初始化（init）命令来源 + MCP 跨平台配置逻辑（v1.4.2）
• GudaStudio/skills – 智能路由（前端→Gemini、后端→Codex）的设计理念
• ace-tool MCP – @mistripple 的轻量级代码检索和 Prompt 增强方案
• linux.do 社区 – 活跃的 Vibe Coding 大型技术交流社区

支持与反馈

• GitHub Issues: 提交问题
• 讨论社区: linux.do – CCG 讨论帖 (留言即可)
• 文档: 完整文档

许可证

本项目采用 MIT License 开源协议。

Copyright (c) 2025 fengshao1227

最后更新: 2026-01-06 | 版本: v1.4.2

Made with