fengshao1227/ccg-workflow

多模型协作工作流引擎 — /ccg:go 一个命令，AI 自动分析意图、选择策略、编排 Codex + Gemini + Claude 协作执行

CCG – Claude + Codex + Gemini 多模型协作

是什么 – ccg-workflow 是一个基于 Node.js 的 CLI，将 Claude Code 转变为其他代码生成模型（OpenAI Codex、xAI Grok、Moonshot Kimi Code、Antigravity）的中心协调器。它向每个 Claude 会话注入一组 JavaScript 钩子，确保模型永不丢失上下文，然后通过一个小型 Go 二进制文件（codeagent-wrapper）将并行分析或实现分派给外部模型。结果是一个“工作流引擎”，能够接收自然语言请求（例如 “为这个 API 添加 JWT 认证”），并自动执行以下操作：

收集项目上下文（git 状态、文件树、技术栈）。
对任务进行分类并选择合适的内置策略。
创建持久化的任务目录（.ccg/tasks/...），包含规格、计划、研究和评审成果。
运行双模型分析或实现，展示一个 硬停止 计划供用户审批，并可选择启动长期运行的“代理团队”来拥有自己的文件。
应用质量门检查（安全、代码质量、文档），最后提交或回滚更改。

核心概念

组件	角色
Claude Code	决定策略并驱动对话的主协调器。
Hook Engine	四个 JS 钩子（`workflow-state.js`、`session-start.js`、`subagent-context.js`、`skill-router.js`）自动将任务状态、项目上下文和领域知识注入每个 Claude 会话。
codeagent-wrapper	编译后的 Go 二进制文件，连接 Claude 与外部 LLM API（Codex、Gemini 等），使它们能并行运行而无需独立 CLI。
Task System	持久化的 `.ccg/tasks/<name>/` 文件夹，存储 JSON 状态、Markdown 计划、研究和评审文件。
Strategies	十种预定义工作流（如 `direct-fix`、`full-collaborate`、`debug-investigate`）根据任务复杂度自动选择。
Quality Gates	内置检查（`/ccg:verify-security`、`/ccg:verify-quality` 等）在变更被接受前运行。
领域知识	超过 100 个 Markdown 文件，涵盖安全、DevOps、AI/MLOps 等；路由器将相关片段注入 Claude 提示。
Skills	独立命令（`/ccg:bt-panel`、`/ccg:seo-page-builder`、`/ccg:adsense-site-auditor`），可在不使用完整多模型引擎的情况下使用。

快速启动选项

选项	你将获得	安装方式
A – 完整安装	多模型协调、所有命令、钩子、Go 桥接、任务引擎。	`npx ccg-workflow`（交互式向导）或 `npx ccg-workflow init --skip-prompt`（非交互式设置）。需要 Node ≥ 20 和 Claude Code CLI。
B – 原生插件	仅包含可重用技能和质量门文件；无外部模型路由或 Go 二进制文件。	`claude plugin marketplace add fengshao1227/ccg-workflow` 后 `claude plugin install ccg@ccg`。通过 `/ccg:<skill>` 调用。

典型工作流（示例）

You: /ccg:go 为这个 API 添加 JWT 认证

CCG Engine:
  1️⃣ 读取 git 状态，检测到一个 Node/Express 后端。
  2️⃣ 分类为 *中等复杂度* 功能 → 选择 `full-collaborate`。
  3️⃣ 创建 `.ccg/tasks/add-jwt-auth/` 并生成 `task.json` 起始文件。
  4️⃣ 并行启动 Codex 和 Gemini 以起草实现。
  5️⃣ 显示 Markdown 计划并等待用户批准（硬停止）。
  6️⃣ 启动一个代理团队，编写代码、运行测试并创建评审报告。
  7️⃣ 运行 `/ccg:verify-security` 和 `/ccg:verify-quality` 质量门检查。
  8️⃣ 提交更改或按请求回滚。

所有状态都持久化在任务文件夹中，因此你可以稍后恢复或审计发生了什么。

关键命令（精选）

/ccg:go – 智能入口点；描述任何开发意图。
/ccg:commit – 生成常规提交消息并创建提交。
/ccg:rollback – 交互式撤销上一个任务。
/ccg:spec-* – OpenSpec 集成（初始化、研究、计划、实现、评审）。
/ccg:bt-panel – 通过其 HTTP API 将构建部署到 Baota/aaPanel 服务器。
/ccg:seo-page-builder – 生成或审计 SEO 导向页面。
npx ccg-workflow dsh install – 作为 DeepSeek Harness 插件（dsh-ccg）安装相同引擎。

安装与配置

# 完整安装（交互式）
npx ccg-workflow

# 或非交互式
npx ccg-workflow init --skip-prompt

配置位于 ~/.claude/ 下：

~/.claude/
├── commands/ccg/          # 斜杠命令定义
├── hooks/ccg/             # 四个 JS 钩子文件
├── skills/ccg/            # 质量门脚本和领域知识
├── .ccg/
│   ├── config.toml        # 模型路由、API 密钥、性能调优
│   ├── engine/            # 策略 JSON + 路由器代码
│   └── prompts/           # 每个外部模型的专家提示
└── bin/codeagent-wrapper  # 编译后的 Go 桥接

环境变量（在 ~/.claude/settings.json 的 "env" 中设置）控制超时和可选的并行团队模式。

使用场景

功能开发 – 以最少的手动编码编写新代码（如认证、API 端点）。
Bug 修复 – 运行 direct-fix 或 debug-investigate 以获取双模型诊断和补丁。
代码审查 / 审计 – 使用 review-audit 策略进行自动化跨模型审查和安全检查。
文档生成 – /ccg:gen-docs 从任务成果自动生成 README/DESIGN 文件。
站点运维 – 通过内置技能部署构建或审计 SEO/AdSense 合规性。

许可与社区

许可证：MIT（宽松，适合商业使用）。
贡献者：README 中列出的 8 名核心贡献者。
支持：X/Twitter @CCG_Workflow，邮件 fengshao1227@gmail.com，GitHub Issues，Linux.do 上的社区论坛。
赞助：APIMart（低成本 AI 图像/视频 API），Gamma Remover（PDF/PPTX 水印工具）。

总结

ccg-workflow 是一个全栈、多模型协调工具，让开发者将 Claude Code 视为“项目经理”，同时将繁重的代码生成和审查任务委派给其他 LLM。它提供持久的任务成果、内置质量门和一组即用型操作技能，所有功能均可通过单个 npx 命令或作为原生 Claude 插件安装。