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

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

📖 目录

核心理念
架构说明
核心特性
快速开始
命令参考
专家角色系统
配置文件
常见问题
致谢

💡 核心理念

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

设计哲学

让 Claude Code 专注于编排决策和代码实施，把具体的代码生成交给专业模型：

前端任务 → Gemini（视觉设计、组件原型）
后端任务 → Codex（逻辑运算、算法调试）
全栈整合 → Claude（工作流控制、代码主权）

核心优势

优势	说明
智能路由	根据任务类型自动选择最合适的模型
交叉验证	双模型并行生成，相互验证减少错误
零写入权限	外部模型只能返回 Patch，Claude 保持代码主权
跨平台支持	macOS、Linux、Windows 自动修复 ✨
Token 优化	ROLE_FILE 动态注入，专家提示词零 token 消耗

🏗️ 架构说明

┌─────────────────────────────────────────────────┐
│          Claude Code CLI (主导编排)              │
│        决策、编排、代码实施、质量把控             │
└──────────────┬──────────────────────────────────┘
               │
       ┌───────┴────────┐
       │                │
       ↓                ↓
┌─────────────┐  ┌─────────────┐
│  Codex CLI  │  │ Gemini CLI  │
│  后端原型   │  │  前端原型   │
│  逻辑算法   │  │  UI 组件    │
└─────────────┘  └─────────────┘
       │                │
       └────────┬───────┘
                ↓
      Unified Diff Patch
    (只读，不能直接修改文件)

安全机制

零写入权限：Codex/Gemini 对文件系统无写入权限
Unified Diff：所有外部模型输出必须为 Patch 格式
脏原型处理：外部模型输出视为"脏原型"，需经 Claude 重构

✨ 核心特性

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

🚀 快速开始

前置要求

必需：
- Claude Code CLI - 主导编排
- Node.js 18+
可选（根据需求）：
- Codex CLI - 后端任务
- Gemini CLI - 前端任务

一键安装

# 交互式安装
npx ccg-workflow

# 选择 "初始化工作流"
# 选择语言（中文 / English）
# 选择 MCP 工具（推荐 ace-tool）
# 等待安装完成（约 1-2 分钟）
# 重启终端

验证安装

# 检查 codeagent-wrapper
codeagent-wrapper --version

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

# 诊断 MCP 配置（v1.4.2 新增）
npx ccg diagnose-mcp

第一个命令

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

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

📚 命令参考

开发工作流命令

命令	用途	模型路由
`/ccg:dev`	完整6阶段开发工作流	MCP + Codex + Gemini
`/ccg:code`	智能代码生成（自动路由）	前端→Gemini / 后端→Codex
`/ccg:frontend`	前端/UI/样式任务	Gemini
`/ccg:backend`	后端/逻辑/算法任务	Codex
`/ccg:debug`	UltraThink 多模型调试	Codex + Gemini 并行
`/ccg:test`	多模型测试生成	Codex + Gemini 并行
`/ccg:bugfix`	质量门控修复（90%+ 通过）	Codex + Gemini 交叉验证
`/ccg:optimize`	性能优化	Codex + Gemini 并行
`/ccg:review`	代码审查（无参数自动审查 git diff）	Codex + Gemini 并行
`/ccg:analyze`	技术分析	Codex + Gemini 并行
`/ccg:think`	深度分析	Codex + Gemini 并行
`/ccg:enhance`	Prompt 增强	ace-tool MCP
`/ccg:scan`	智能仓库扫描	分析项目结构
`/ccg:feat`	智能功能开发（规划→实施→审查）	多模型协作

Git 工具命令

命令	用途
`/ccg:commit`	智能 commit：分析改动，生成 conventional commit 信息
`/ccg:rollback`	交互式回滚：列分支、列版本、二次确认
`/ccg:clean-branches`	分支清理：安全查找并清理已合并分支
`/ccg:worktree`	Worktree 管理：在 `../.ccg/项目名/` 下创建

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

命令	用途
`npx ccg diagnose-mcp`	诊断 MCP 配置问题
`npx ccg fix-mcp`	修复 Windows MCP 配置（Windows 用户）

🎭 专家角色系统

核心机制：ROLE_FILE 动态注入

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

✅ 每个命令自动注入对应角色提示词
✅ 不占用主会话 token
✅ 无需手动配置全局提示词

角色映射表

命令	Codex 角色	Gemini 角色
`/ccg:code`, `/ccg:backend`	architect.md（后端架构师）	-
`/ccg:frontend`	-	frontend.md（前端架构师）
`/ccg:analyze`, `/ccg:think`	analyzer.md	analyzer.md
`/ccg:debug`	debugger.md	debugger.md
`/ccg:test`	tester.md	tester.md
`/ccg:review`, `/ccg:bugfix`	reviewer.md	reviewer.md
`/ccg:optimize`	optimizer.md	optimizer.md

提示词文件结构

~/.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
│   ├── debugger.md
│   ├── optimizer.md
│   ├── reviewer.md
│   └── tester.md
└── claude/        # Claude CLI 全栈专家（6个）
    ├── architect.md
    ├── analyzer.md
    ├── debugger.md
    ├── optimizer.md
    ├── reviewer.md
    └── tester.md

⚙️ 配置文件

配置文件位于 ~/.claude/.ccg/config.toml：

[general]
version = "1.4.2"
language = "zh-CN"

[mcp]
provider = "ace-tool"  # ace-tool | auggie | none

[routing]
mode = "smart"  # smart | parallel | sequential

[routing.frontend]
models = ["gemini"]
primary = "gemini"
strategy = "fallback"

[routing.backend]
models = ["codex"]
primary = "codex"
strategy = "fallback"

🗂️ 安装目录结构

~/.claude/
├── commands/ccg/           # ✅ Claude Code 读取的 slash commands
│   ├── dev.md, code.md, frontend.md, backend.md
│   ├── debug.md, test.md, bugfix.md, review.md
│   ├── optimize.md, analyze.md, think.md, enhance.md
│   ├── scan.md, feat.md, commit.md, rollback.md
│   ├── clean-branches.md, worktree.md, init.md
├── agents/ccg/             # ✅ Claude Code 读取的 subagents
│   ├── planner.md, ui-ux-designer.md
│   ├── init-architect.md, get-current-datetime.md
├── bin/                    # ✅ 二进制文件
│   └── codeagent-wrapper   # (Windows 自动包装 MCP 命令)
└── .ccg/                   # ✅ CCG 配置目录（v1.4.0+）
    ├── config.toml         # 主配置文件
    ├── shared-config.md    # 共享配置
    ├── backup/             # ✨ v1.4.2 新增：自动备份
    └── prompts/            # 专家提示词
        ├── codex/, gemini/, claude/

❓ 常见问题

Q1: Windows 用户 MCP 安装后不工作怎么办？

v1.4.2 已自动修复！

新用户：

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

现有用户：

# 诊断问题
npx ccg diagnose-mcp

# 一键修复
npx ccg fix-mcp

手动验证：

# 检查配置是否正确
cat ~/.claude.json

# 应该看到 "command": "cmd", "args": ["/c", "npx", ...]

Q2: 如何更新到 v1.4.2？

一键更新，无需卸载：

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

更新会自动：

检测 npm 最新版本
增量更新命令模板和提示词
保留用户配置和 MCP 设置
自动迁移旧版本目录结构（v1.3.x → v1.4.x）
应用 Windows MCP 修复（v1.4.2）

Q3: v1.4.0 目录迁移会影响我吗？

不会影响，系统会自动迁移：

旧位置 → 新位置：

~/.ccg/                    → ~/.claude/.ccg/
~/.claude/prompts/ccg/     → ~/.claude/.ccg/prompts/
~/.claude/commands/ccg/    → 保持不变

安装/更新时会自动：

检测旧版本目录
迁移所有文件到新位置
清理旧目录（安全检查后）
显示迁移报告

Q4: MCP 工具如何选择？

ace-tool（推荐）：

✅ 开箱即用
✅ Prompt 增强 + 代码检索
✅ 无需额外配置
📖 获取 Token: https://augmentcode.com/

auggie（官方）：

✅ 代码检索（开箱即用）
⚠️ Prompt 增强需额外配置
📖 配置教程: https://linux.do/t/topic/1280612

切换方法：

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

Q5: codeagent-wrapper 是什么？

来自 cexll/myclaude 的 Go 工具，封装了多 CLI 调用：

支持 --backend codex/gemini/claude 切换
会话管理（SESSION_ID）
ROLE_FILE 动态注入
v1.4.2 新增：Windows 命令自动包装

调用语法：

codeagent-wrapper --backend <codex|gemini|claude> - [工作目录] <<'EOF'
<任务内容>
EOF

Q6: 安装后提示 "codeagent-wrapper: command not found"？

原因：PATH 未生效。

解决方案：

Mac/Linux：

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

Windows：

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

Q7: 如何卸载 CCG 系统？

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

卸载会：

删除 ~/.claude/commands/ccg/ 命令文件
删除 ~/.claude/agents/ccg/ 子智能体
删除 ~/.claude/bin/codeagent-wrapper 二进制
删除 ~/.claude/.ccg/ 配置目录（可选保留）

🙏 致谢

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

cexll/myclaude - codeagent-wrapper 多后端调用工具
UfoMiao/zcf - Git 工具 + MCP 跨平台配置逻辑（v1.4.2）
GudaStudio/skills - 智能路由设计理念
ace-tool MCP - 轻量级代码检索和 Prompt 增强方案
linux.do 社区 - 活跃的 Vibe Coding 大型技术交流社区

💬 支持与反馈

GitHub Issues: 提交问题
讨论社区: linux.do - CCG 讨论帖
完整文档: README.md

📄 许可证

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

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

Made with ❤️ by the CCG Community

README.md Unescape Escape

CCG - Claude + Codex + Gemini 多模型协作系统

🎯 v1.4.2 重大改进

✨ Windows 用户福音

技术细节