Coder-Codex-Gemini CLAUDE.md

Coder-Codex-Gemini (CCG)

Claude + Coder + Codex + Gemini 多模型协作 MCP 服务器

项目定位

一个统一的 MCP 服务器，让 Claude (Opus) 作为架构师调度 Coder 执行代码任务、Codex 审核代码质量、Gemini 提供专家咨询，形成自动化的多方协作闭环。

核心价值

维度	价值
成本优化	Opus 负责思考（贵但强），Coder 负责执行（量大管饱）
能力互补	Opus 补足 Coder 创造力短板，Codex 提供独立审核视角，Gemini 提供多元化专家意见
质量保障	双重审核机制（Claude 初审 + Codex 终审）
全自动闭环	拆解 → 执行 → 审核 → 重试，无需人工干预

角色分工

Claude (Opus)     →  架构师 + 初审官 + 终审官 + 协调者
Coder (可配置)    →  代码执行者（生成、修改、批量任务）
Codex (OpenAI)    →  独立代码审核者（质量把关）
Gemini (可选)     →  多面手专家（架构设计、第二意见、前端/UI）

项目结构

Coder-Codex-Gemini/
├── src/ccg_mcp/              # 源代码
│   ├── __init__.py
│   ├── cli.py                # 入口点
│   ├── server.py             # MCP 服务器主体
│   ├── config.py             # 配置加载
│   └── tools/
│       ├── coder.py          # Coder 工具
│       ├── codex.py          # Codex 工具
│       └── gemini.py         # Gemini 工具
├── skills/                   # Skills 工作流指导
│   ├── ccg-workflow/         # CCG 协作流程
│   └── gemini-collaboration/ # Gemini 协作指南
├── templates/                # 模板文件
│   └── ccg-global-prompt.md  # 全局 CLAUDE.md 模板
├── cases/                    # 实测案例
├── pyproject.toml
├── config.example.toml       # 配置文件示例
├── setup.sh                  # Unix/macOS 安装脚本
├── setup.ps1                 # Windows PowerShell 安装脚本
├── setup.bat                 # Windows 批处理入口
├── README.md                 # 项目说明（中文）
├── README_EN.md              # 项目说明（英文）
└── CLAUDE.md                 # 本文件

开发里程碑

阶段	内容	状态
M0	方案设计、技术验证	✅ 完成
M1	最小可用版本（coder 工具）	✅ 完成
M2	集成 codex 工具	✅ 完成
M3	协作 Prompt 优化	✅ 完成
M4	集成 gemini 工具	✅ 完成
M5	文档、发布	✅ 完成

技术要点

MCP 工具

• coder: 调用可配置后端模型执行代码生成/修改，默认 workspace-write
• codex: 调用 Codex 进行代码审核，默认 read-only
• gemini: 调用 Gemini CLI 进行专家咨询或代码执行，默认 workspace-write

核心特性

结构化错误

失败时返回 error_kind 和 error_detail，便于上层决策是否重试：

{
  "success": false,
  "error": "错误摘要",
  "error_kind": "timeout | upstream_error | ...",
  "error_detail": {
    "message": "错误简述",
    "exit_code": 1,
    "last_lines": ["最后20行输出..."],
    "retries": 0
  }
}