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	4つの 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	10種類の事前定義されたワークフロー（例：`direct-fix`、`full-collaborate`、`debug-investigate`）がタスクの複雑さに基づいて自動選択。
Quality Gates	変更が承認される前に実行される組み込みチェック（`/ccg:verify-security`、`/ccg:verify-quality` など）。
ドメイン知識	セキュリティ、DevOps、AI/MLOps など、100以上の Markdown ファイル。ルーターが関連するスニペットを 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 this API に JWT 認証を追加する

CCG Engine:
  1️⃣ git 状態を読み取り、Node/Express バックエンドであると検出。
  2️⃣ *中程度の複雑さ*の機能と分類 → `full-collaborate` を選択。
  3️⃣ `.ccg/tasks/add-jwt-auth/` を作成し、`task.json` のスターターを配置。
  4️⃣ Codex と Gemini を並列で起動し、実装草案を生成。
  5️⃣ マークダウン形式の計画を表示し、ユーザー承認を待機（ハードストップ）。
  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/             # 4つの JS フックファイル
├── skills/ccg/            # 品質ゲートスクリプトとドメイン知識
├── .ccg/
│   ├── config.toml        # モデルルーティング、APIトークン、パフォーマンスチューニング
│   ├── engine/            # 戦略JSON + ルーター コード
│   └── prompts/           # 各外部モデル用のエキスパートプロンプト
└── bin/codeagent-wrapper  # コンパイル済みの Go ブリッジ

環境変数（~/.claude/settings.json の "env" に設定）でタイムアウトやオプションの並列チームモードを制御。

用途例

機能開発 – 認証、APIエンドポイントなど、最小限の手動コーディングで新コードを書く。
バグ修正 – 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 プラグインでインストール可能です。