@hunyed15/codecgc

多模型协作的代码工作流编排器。Claude 负责规划和审核，Codex 执行后端，Gemini 执行前端——CodeCGC 把它们串成可追踪、可审计的闭环。

为什么需要它

当你同时使用多个 AI 编码助手时，缺少一个统一的调度层：

• 谁改哪些文件？路径归属不清晰
• 执行结果在哪？没有审计记录
• 前后端改动如何协调？缺少拆分和闭环机制

CodeCGC 解决这些问题：一个需求进来，自动拆分、路由、执行、审核、关闭。

安装

npm install -g @hunyed15/codecgc

全局安装后，postinstall 自动释放 Skill 文件到 ~/.claude/skills/。 你可以直接在任何项目的 Claude Code 中使用 /cgc-init、/cgc-entry 等命令，无需额外配置。

快速开始

# 1. 在 Claude Code 中初始化项目
/cgc-init

# 2. 创建工作流
/cgc 实现用户登录功能

# 3. 或使用具体命令
/cgc-entry    → 创建 workflow
/cgc-plan     → 规划步骤
/cgc-build    → 执行 feature
/cgc-review   → 审核结果

也可以在终端中使用 CLI：

cd your-project
cgc-init
cgc "实现用户登录功能"

初始化后项目结构：

your-project/
├── .codecgc/
│   ├── features/             # feature workflow 产物
│   ├── issues/               # issue workflow 产物
│   ├── execution/            # 执行审计记录
│   └── ...                   # 其他工作流产物
├── .codecgc/config/routing.yaml  # 路径归属策略
├── .claude/CLAUDE.md         # AI 提示词（Claude Code 读取）
└── .mcp.json                 # MCP 服务器配置

架构

┌─────────────────────────────────────────────────┐
│                   Claude Code                    │
│         （规划、审核、需求澄清、验收）            │
└────────────────────┬────────────────────────────┘
                     │ MCP
┌────────────────────▼────────────────────────────┐
│               codecgcmcp（主控）                  │
│  entry → plan → route → build/fix → review      │
└───────┬─────────────────────────────┬───────────┘
        │ MCP                         │ MCP
┌───────▼───────┐             ┌───────▼───────┐
│   codexmcp    │             │  geminimcp    │
│  （后端执行）  │             │ （前端执行）   │
│   Codex CLI   │             │  Gemini CLI   │
└───────────────┘             └───────────────┘

MCP 工具

| 工具 | 用途 | |------|------| | codecgc.init | 初始化项目 | | codecgc.entry | 创建/恢复 workflow | | codecgc.plan | 添加执行步骤 | | codecgc.build | 执行 feature 步骤 | | codecgc.fix | 执行 issue 修复 | | codecgc.test | 执行测试步骤 | | codecgc.review | 审核执行结果 | | codecgc.continue | 续接执行 session | | codecgc.explain | 解释 workflow 状态 | | codecgc.route | 路径归属判断 | | codecgc.history | 查询历史记录 | | codecgc.status | 全局状态摘要 | | codecgc.doctor | 环境健康检查 | | codecgc.audit | 工作流完整性审计 | | codecgc.manual | 手动标记步骤完成 |

工作流程

需求 → entry → plan → route → build/fix → review → 关闭
                                   ↑                  │
                                   └── changes-requested

1. entry — 创建 workflow（feature 或 issue）
2. plan — Claude 规划步骤，指定每步的 executor 和路径
3. route — 根据 .codecgc/config/routing.yaml 验证路径归属
4. build/fix — 调用 Codex（后端）或 Gemini（前端）执行
5. review — Claude 审核执行结果，通过或打回
6. 打回后回到 build/fix 继续，通过则关闭

路由策略

.codecgc/config/routing.yaml 定义路径归属：

version: 1
rules:
  - patterns: ["**/*.py", "**/api/**", "**/backend/**"]
    ownership: backend
  - patterns: ["**/*.tsx", "**/components/**", "**/pages/**"]
    ownership: frontend
  - patterns: ["**/*.md", "**/docs/**"]
    ownership: docs
  - patterns: ["**/shared/**", "**/utils/**"]
    ownership: shared

执行器只能修改归属范围内的文件，越界会被 review 驳回。

CLI 命令

| 命令 | 用途 | |------|------| | cgc-init | 初始化项目 | | cgc-mcp | 启动 MCP 服务器 |

常见问题

终端提示 cgc-init 命令不存在

确认安装的是包含 cgc-init 的新版包，并检查 npm 全局 bin 目录是否在 PATH 中：

npm install -g @hunyed15/codecgc@latest
npm config get prefix

Windows 下可进一步确认：

where cgc
where cgc-init
where cgc-mcp

macOS / Linux 下可进一步确认：

which cgc
which cgc-init
which cgc-mcp

如果 cgc 可用但 cgc-init 不可用，也可以先使用等价命令：

cgc init

/cgc-init 成功但项目里没有其它 skills

查看初始化结果里的 project_root 和 project_skills.target_dir。项目级 skills 应释放到：

<project>/.claude/skills/<skill-name>/SKILL.md

如果 warnings 提示未找到包内 skills 源目录，请重新全局安装包后再次运行 /cgc-init。

环境要求

• Node.js >= 20
• Codex CLI（后端执行需要）
• Gemini CLI（前端执行需要）

发布

项目通过 GitHub Actions 自动发布。推送 tag 即触发：

npm version patch   # 或 minor / major
git push --tags

License

MIT