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 外掛安裝。