mcpField
M
multi-ai-consultant

multi-ai-consultant

github.com/secondskyエージェントワークフロー240390 回インストール5 週間前に更新
リポジトリ

multi-ai-consultant について

Claude Code がデバッグで行き詰まった場合や判断の検証が必要な場合に、Gemini、Codex、新しい Claude セッションへ意見を求めるスキルです。MCP サーバーではなく既存の CLI を使い、相談コマンド、意見の統合、プライバシー確認、費用記録を提供します。

主な機能

  1. 01Gemini、Codex、Claudeへの相談
  2. 02バグや判断に応じた相談の提案
  3. 03意見の統合と推奨アクション
  4. 04共有前のプライバシー除外確認
  5. 05相談費用の記録

活用シーン

  1. 01デバッグの試行後に別の見解を得る
  2. 02アーキテクチャやセキュリティ判断の検証
  3. 03リポジトリを踏まえたコードレビュー

MCP 対応

このスキルは MCP サーバーを使わず、既存の CLI と Claude Code のコマンドを利用します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/secondsky/claude-skills --skill multi-ai-consultant

インストール後、Claude Code で/multi-ai-consultantを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

examples/
sample-consultation.md
references/
ai-strengths.md
commands-reference.md
setup-guide.md
troubleshooting.md
usage-examples.md
scripts/
setup-apis.sh
templates/
.geminiignore
codex.md
consultation-log-parser.sh
GEMINI.md

詳細

Multi-AI Consultant

Claude Code が行き詰まったときや重要な決定を下すときに、外部 AI にセカンドオピニオンを求めます。


このスキルでできること

このスキルを使うと、今後の Claude Code セッションで、次の場合に他の AI に相談できます。

  • バグの修正を一度試して失敗した後も行き詰まっている
  • アーキテクチャ上の決定を下す
  • セキュリティ上の懸念を検証する必要がある
  • 新たな視点が必要である

主な革新点:MCP サーバーを構築するのではなく、既存の CLI ツール(gemini、codex)を使用するため、はるかにシンプルでメンテナンスしやすくなります。


このスキルを使用するタイミング

自動トリガー(ユーザーの操作は不要)

次の場合、Claude Code はこのスキルの使用を自動的に提案します。

  1. デバッグを1回試して失敗した後

    • バグを修正する方法を1つ試した
    • それでも動作しない、または別のエラーが発生する
    • → 提案:「セカンドオピニオンを求めて、[Gemini|Fresh Claude] に相談しましょうか?」
  2. アーキテクチャ上の決定を下す前

    • 重要な設計上の選択(状態管理、ルーティング、データフロー)
    • フレームワークの選定
    • データベーススキーマの設計
    • → 自動で相談(ユーザーに伝えます):「アーキテクチャを検証するために Gemini に相談しています……」
  3. セキュリティの変更

    • 認証ロジック
    • 認可ルール
    • 暗号化
    • 入力検証
    • → 自動で相談:「セキュリティの方針を確認するために Gemini に相談しています……」
  4. 確信が持てない場合

    • 有効な方法が複数ある
    • トレードオフが明確でない
    • ドキュメント内で助言が食い違っている
    • → 提案:「別の AI に相談して、追加の視点を得ましょうか?」
手動での呼び出し(ユーザーのコマンド)

ユーザーは次のコマンドで明示的に相談を依頼できます。

  • /consult-gemini [question] - 思考機能、検索、グラウンディングを備えた Gemini 2.5 Pro
  • /consult-codex [question] - Codex CLI 経由の OpenAI GPT-4(リポジトリを認識)
  • /consult-claude [question] - 新しい Claude サブエージェント(無料、高速)
  • /consult-ai [question] - 使用する AI を尋ねるルーター

3つの AI

AIツール使用するタイミング特別な機能コスト
Gemini 2.5 Progemini CLIウェブ調査、最新のドキュメント、思考Google Search、拡張推論、グラウンディング~$0.10-0.50
OpenAI GPT-4codex CLIリポジトリを認識した分析、コードレビューディレクトリを自動スキャン、OpenAI の推論~$0.05-0.30
Fresh ClaudeTask ツール手早いセカンドオピニオン、低コスト同等の機能、新鮮な視点無料

AI の詳細な比較:具体的な用途に応じて相談する AI を選ぶ際は、references/ai-strengths.md を読み込んでください。


仕組み

アーキテクチャ
Claude Code encounters bug/decision
        ↓
Suggests consultation (or user requests)
        ↓
User approves
        ↓
Execute appropriate slash command
        ↓
CLI command calls external AI
        ↓
Parse response
        ↓
Synthesize: Claude's analysis + External AI's analysis
        ↓
Present 5-part comparison
        ↓
Ask permission to implement
5部構成の統合フォーマット

すべての相談で、オウム返しを防ぐために次の形式を使用します。

  1. 🤖 私の分析 - Claude 独自の推論と試行内容
  2. 💎/🔷/🔄 他の AI の分析 - 外部 AI の回答全文
  3. 🔍 主な違い - 一致点、相違点、それぞれの AI が気付いた点/見落とした点
  4. ⚡ 統合 - 複合的な視点、根本原因、トレードオフ
  5. ✅ 推奨する対応 - ファイルパスや行番号を含む具体的な次の手順

最後に:「この方法で進めましょうか?」と確認します。


セットアップ

インストール手順の全容:CLI のインストール、API キーの設定、テンプレートの準備を行う際は、references/setup-guide.md を読み込んでください。

クイックセットアップ:

  1. CLI をインストール:bun add -g @google/generative-ai-cli(Gemini)、bun add -g codex(Codex、任意)
  2. API キーを設定:export GEMINI_API_KEY="..."、export OPENAI_API_KEY="..."
  3. スキルをインストール:~/.claude/skills/multi-ai-consultant にシンボリックリンクを作成します
  4. テンプレートをコピー:GEMINI.md、codex.md、.geminiignore をプロジェクトのルートに配置します
  5. 動作を確認:gemini -p "test"、codex exec - --yolo

API キーの取得先:


使用方法

詳しい例について:相談ワークフローを学んだり、実際のシナリオを確認したりする場合は、references/usage-examples.md を読み込んでください。

簡単な例:

  • バグ:1回試して失敗した後 → /consult-gemini でウェブ調査に基づく解決策を確認
  • アーキテクチャ:設計上の判断 → /consult-gemini で最新のベストプラクティスを確認
  • コードレビュー:リファクタリングの検証 → /consult-codex でリポジトリを考慮した整合性チェック
  • 簡単な意見:妥当性の確認 → /consult-claude で無料の新鮮な視点を得る

詳しい例を5つ用意しています:

  1. JWT 認証のバグ(約30分を節約し、プラットフォーム固有の問題を発見)
  2. 状態管理の選択(2025年のパターンに基づく、情報を得たうえでの判断)
  3. リファクタリングのレビュー(3つの整合性の問題を発見)
  4. セキュリティの検証(OWASP 2025 に基づき、2つの重大な問題を発見)
  5. 複数の AI を活用したワークフロー(重要度の高いデータベース選択)

スラッシュコマンド

コマンドの詳細なリファレンスについて:詳しい構文、オプション、コスト追跡情報が必要な場合は、references/commands-reference.md を読み込んでください。

コマンドの概要:

/consult-gemini [question]
  • 用途:ウェブ調査、最新のドキュメント、拡張思考
  • 機能:Google 検索、グラウンディング、思考モード
  • コスト:~$0.10-0.50
  • 例:/consult-gemini Is this JWT secure by 2025 standards?
/consult-codex [question]
  • 用途:リポジトリを考慮した分析、コードレビュー
  • 機能:ディレクトリを自動スキャン、整合性チェック
  • コスト:~$0.05-0.30
  • 例:/consult-codex Review for performance bottlenecks
/consult-claude [question]
  • 用途:手軽なセカンドオピニオン、低コスト
  • 機能:無料、高速、新鮮な視点
  • コスト:無料
  • 例:/consult-claude Am I missing something obvious?
/consult-ai [question]
  • 用途:ルーター(使用する AI を推奨)
  • 機能:質問を分析し、最適な AI を提案
  • コスト:選択した AI によって異なります
  • 例:/consult-ai How should we structure this architecture?

テンプレート

テンプレートを使うと、相談時の AI の動作をカスタマイズできます(プロジェクトのルートから自動的に読み込まれます)。

  1. GEMINI.md - Gemini のシステム指示(5部構成の形式とウェブ検索を強制)
  2. codex.md - Codex のシステム指示(リポジトリを考慮した分析を強制)
  3. .geminiignore - .gitignore を超えるプライバシー除外設定
  4. consultation-log-parser.sh - 相談履歴を表示(任意)

インストール:~/.claude/skills/multi-ai-consultant/templates/ からプロジェクトのルートにコピーします


プライバシーとセキュリティ

自動保護:

  • どちらの CLI も .gitignore を自動的に尊重します
  • 追加の除外設定(.env*、*secret*、*credentials*)には .geminiignore を作成します
  • 相談前のチェックで、機密性の高いパターンが検出された場合に警告します

プライバシー保護のベストプラクティス:

  • .gitignore を適切に設定します
  • 安全性を高めるため、.geminiignore を作成します
  • スマートなコンテキスト選択を使用します(リポジトリ全体ではなく、特定のファイルを選択)
  • 送信される内容を確認します:git status --ignored

詳しいプライバシー設定について:.geminiignore やプライバシー除外設定を行う場合は、references/setup-guide.md を読み込んでください。


コスト追跡

相談はすべて ~/.claude/ai-consultations/consultations.log に記録されます

ログ形式:timestamp,ai,model,input_tokens,output_tokens,cost,project_path

ログの表示:consultation-log-parser.sh --summary

出力例:

Total consultations: 47
Gemini: 23 ($4.25), Codex: 12 ($1.85), Fresh Claude: 12 ($0.00)
Total cost: $6.10

詳しいコスト追跡について:ログの表示、コストの計算、予算の管理を行う場合は、references/commands-reference.md を読み込んでください。


よくある問題

トラブルシューティングの詳細:エラーやセットアップの問題が発生した場合は、references/troubleshooting.md を読み込んでください。

よくある問題トップ 5:

  1. CLI がインストールされていない:gemini: command not found → 対処法:bun add -g @google/generative-ai-cli
  2. API キーが無効:認証に失敗する → 対処法:export GEMINI_API_KEY="..."
  3. コンテキストが大きすぎる:トークン上限を超過する → 対処法:リポジトリ全体ではなく、特定のファイルを使用してください
  4. プライバシー情報の漏えい:.env ファイルが送信される → 対処法:.gitignore と .geminiignore に追加してください
  5. スキルが見つからない:動作しない → 対処法:~/.claude/skills/multi-ai-consultant を確認してください

トークン効率

このスキルを使わない場合

典型的な状況(バグで行き詰まった場合):

  1. アプローチ 1 を試す(約 4k トークン)
  2. CLI の構文を調べる(約 3k トークン)
  3. アプローチ 2 を試す(約 4k トークン)
  4. ドキュメントを調べる(約 3k トークン)
  5. アプローチ 3 を試す(約 4k トークン)

合計:約 20k トークン、30~45 分

このスキルを使う場合

同じ状況:

  1. アプローチ 1 を試す(約 4k トークン)
  2. /consult-gemini を実行する(約 1k トークン)
  3. Gemini が問題を見つける(5k トークン未満、別途請求)
  4. 修正を実装する(約 3k トークン)

合計:約 8k トークン、5~10 分

節約量:トークン約 60%、時間約 75%


成功指標

時間効率
  • スキルなし:30~45 分(試行錯誤)
  • スキルあり:5~10 分(相談+修正)
  • 節約量:約 75%
トークン効率
  • スキルなし:約 20k トークン(複数回の試行)
  • スキルあり:約 8k トークン(1 回の相談)
  • 節約量:約 60%
エラーの防止
  • CLI を手動で使用:よくあるエラーが 3~5 件(フラグ、解析、プライバシー)
  • スキルあり:エラー 0 件(すべてコマンドで処理)
  • 防止率:100%
品質
  • 手動:内容を統合できないリスクがある(外部 AI の回答をそのままコピーするだけ)
  • スキルあり:GEMINI.md/codex.md を介して統合を必須化
  • 改善:確実に付加価値を提供

MCP ではなく CLI を使う理由

項目MCP サーバーCLI アプローチ
セットアップ時間4~6 時間60~75 分
複雑さ高(MCP プロトコル)低(bash + CLI)
メンテナンスMCP SDK を更新CLI を更新(まれ)
柔軟性AI が固定されるCLI があればどの AI でも利用可能
デバッグMCP プロトコル標準の bash
依存関係MCP SDK、npmCLI のみ

最良の選択:CLI アプローチ — 労力を 80%削減し、同じ機能を実現


参照ファイルを読み込むタイミング

AI への相談で特定の作業を行う場合は、参照ファイルを読み込んでください。

ai-strengths.md

次の場合に読み込みます:

  • 選択に関する作業:相談する AI を選ぶ場合(Gemini、Codex、新しい Claude のどれにするか)
  • 比較に関する作業:AI 間の機能、コスト、トレードオフを把握する場合
  • 戦略に関する作業:組み合わせ戦略を計画する場合(無料 → 有料、まず有料、予算重視)
  • 機能に関する作業:特殊な機能を把握する場合(Google Search、拡張思考、グラウンディング、リポジトリ対応、新鮮な視点)
  • シナリオに関する作業:複数の AI への相談ワークフロー、検証ワークフロー
setup-guide.md

次の場合に読み込みます:

  • インストールに関する作業:Gemini CLI、Codex CLI のセットアップ、またはスキルのインストール
  • 設定に関する作業:API キー、環境変数、システムパスの設定
  • プライバシーに関する作業:.geminiignore、プライバシー除外、セキュリティ設定のセットアップ
  • テンプレートに関する作業:GEMINI.md、codex.md、.geminiignore、consultation-log-parser.sh のインストール
  • 検証に関する作業:CLI のインストール、API キー、スキルの検出をテストする場合
commands-reference.md

次の場合に読み込みます:

  • コマンドに関する作業:/consult-gemini、/consult-codex、/consult-claude、/consult-ai の使用
  • 構文に関する作業:コマンドのフラグ、オプション、コンテキストの選択を把握する場合
  • コストに関する作業:コスト追跡、ログ形式、相談履歴の表示方法を把握する場合
  • ログに関する作業:consultation-log-parser.sh の使用、または相談パターンの分析
usage-examples.md

次の場合に読み込んでください:

  • シナリオ別:バグ、アーキテクチャ上の決定、コードレビューでスキルを使用する方法を学ぶ場合
  • ワークフロー別:相談のワークフロー、統合プロセス、複数の AI を使うアプローチを理解する場合
  • 例別:相談とその結果の実例を見る場合(詳細な例を 5 件掲載)
troubleshooting.md

次の場合に読み込んでください:

  • エラー別:特定のエラー(コマンドが見つからない、API キーが無効、解析の失敗など)が発生した場合
  • 診断別:CLI の問題、API 接続、スキルの検出をトラブルシューティングする場合
  • 修正別:既知の問題を手順ごとの解決策で解消する場合(よくある問題を 8 件記載)
  • デバッグ別:CLI を手動でテストする、設定を確認する、インストールを検証する場合

貢献

問題を見つけましたか?

  • troubleshooting.md に記録してください
  • 修正方法や回避策を含めてください
  • 再発防止のためスラッシュコマンドを更新してください

新しい AI を追加しますか?

  • 新しいスラッシュコマンドを作成します:commands/consult-newai.md
  • ルーターに追加します:commands/consult-ai.md を更新してください
  • テンプレートを作成します:templates/newai.md(CLI がシステム指示に対応している場合)
  • ドキュメントを更新してください

統合を改善しますか?

  • テンプレートを編集します:templates/GEMINI.md、templates/codex.md
  • 実際の相談でテストしてください
  • 改善前後の品質を測定してください

参考資料

外部リソース
内部ファイル
  • 計画ドキュメント:planning/multi-ai-consultant-*.md
  • スラッシュコマンド:commands/*.md
  • テンプレート:templates/*
  • スクリプト:scripts/*
  • 参考資料:references/*.md(参考ファイル 5 件)

ライセンス

MIT License - LICENSE ファイルを参照してください


最終更新日:2025-11-07 ステータス:本番環境で利用可能 メンテナー:Claude Skills Maintainers | [email protected]

コメント