multi-ai-consultant について
Claude Code がデバッグで行き詰まった場合や判断の検証が必要な場合に、Gemini、Codex、新しい Claude セッションへ意見を求めるスキルです。MCP サーバーではなく既存の CLI を使い、相談コマンド、意見の統合、プライバシー確認、費用記録を提供します。
主な機能
- 01Gemini、Codex、Claudeへの相談
- 02バグや判断に応じた相談の提案
- 03意見の統合と推奨アクション
- 04共有前のプライバシー除外確認
- 05相談費用の記録
活用シーン
- 01デバッグの試行後に別の見解を得る
- 02アーキテクチャやセキュリティ判断の検証
- 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.mdreferences/ai-strengths.mdcommands-reference.mdsetup-guide.mdtroubleshooting.mdusage-examples.mdscripts/setup-apis.shtemplates/.geminiignorecodex.mdconsultation-log-parser.shGEMINI.md詳細
Multi-AI Consultant
Claude Code が行き詰まったときや重要な決定を下すときに、外部 AI にセカンドオピニオンを求めます。
このスキルでできること
このスキルを使うと、今後の Claude Code セッションで、次の場合に他の AI に相談できます。
- バグの修正を一度試して失敗した後も行き詰まっている
- アーキテクチャ上の決定を下す
- セキュリティ上の懸念を検証する必要がある
- 新たな視点が必要である
主な革新点:MCP サーバーを構築するのではなく、既存の CLI ツール(gemini、codex)を使用するため、はるかにシンプルでメンテナンスしやすくなります。
このスキルを使用するタイミング
自動トリガー(ユーザーの操作は不要)
次の場合、Claude Code はこのスキルの使用を自動的に提案します。
-
デバッグを1回試して失敗した後
- バグを修正する方法を1つ試した
- それでも動作しない、または別のエラーが発生する
- → 提案:「セカンドオピニオンを求めて、[Gemini|Fresh Claude] に相談しましょうか?」
-
アーキテクチャ上の決定を下す前
- 重要な設計上の選択(状態管理、ルーティング、データフロー)
- フレームワークの選定
- データベーススキーマの設計
- → 自動で相談(ユーザーに伝えます):「アーキテクチャを検証するために Gemini に相談しています……」
-
セキュリティの変更
- 認証ロジック
- 認可ルール
- 暗号化
- 入力検証
- → 自動で相談:「セキュリティの方針を確認するために Gemini に相談しています……」
-
確信が持てない場合
- 有効な方法が複数ある
- トレードオフが明確でない
- ドキュメント内で助言が食い違っている
- → 提案:「別の 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 Pro | gemini CLI | ウェブ調査、最新のドキュメント、思考 | Google Search、拡張推論、グラウンディング | ~$0.10-0.50 |
| OpenAI GPT-4 | codex CLI | リポジトリを認識した分析、コードレビュー | ディレクトリを自動スキャン、OpenAI の推論 | ~$0.05-0.30 |
| Fresh Claude | Task ツール | 手早いセカンドオピニオン、低コスト | 同等の機能、新鮮な視点 | 無料 |
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部構成の統合フォーマット
すべての相談で、オウム返しを防ぐために次の形式を使用します。
- 🤖 私の分析 - Claude 独自の推論と試行内容
- 💎/🔷/🔄 他の AI の分析 - 外部 AI の回答全文
- 🔍 主な違い - 一致点、相違点、それぞれの AI が気付いた点/見落とした点
- ⚡ 統合 - 複合的な視点、根本原因、トレードオフ
- ✅ 推奨する対応 - ファイルパスや行番号を含む具体的な次の手順
最後に:「この方法で進めましょうか?」と確認します。
セットアップ
インストール手順の全容:CLI のインストール、API キーの設定、テンプレートの準備を行う際は、references/setup-guide.md を読み込んでください。
クイックセットアップ:
- CLI をインストール:
bun add -g @google/generative-ai-cli(Gemini)、bun add -g codex(Codex、任意) - API キーを設定:
export GEMINI_API_KEY="..."、export OPENAI_API_KEY="..." - スキルをインストール:
~/.claude/skills/multi-ai-consultantにシンボリックリンクを作成します - テンプレートをコピー:
GEMINI.md、codex.md、.geminiignoreをプロジェクトのルートに配置します - 動作を確認:
gemini -p "test"、codex exec - --yolo
API キーの取得先:
使用方法
詳しい例について:相談ワークフローを学んだり、実際のシナリオを確認したりする場合は、references/usage-examples.md を読み込んでください。
簡単な例:
- バグ:1回試して失敗した後 →
/consult-geminiでウェブ調査に基づく解決策を確認 - アーキテクチャ:設計上の判断 →
/consult-geminiで最新のベストプラクティスを確認 - コードレビュー:リファクタリングの検証 →
/consult-codexでリポジトリを考慮した整合性チェック - 簡単な意見:妥当性の確認 →
/consult-claudeで無料の新鮮な視点を得る
詳しい例を5つ用意しています:
- JWT 認証のバグ(約30分を節約し、プラットフォーム固有の問題を発見)
- 状態管理の選択(2025年のパターンに基づく、情報を得たうえでの判断)
- リファクタリングのレビュー(3つの整合性の問題を発見)
- セキュリティの検証(OWASP 2025 に基づき、2つの重大な問題を発見)
- 複数の 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 の動作をカスタマイズできます(プロジェクトのルートから自動的に読み込まれます)。
- GEMINI.md - Gemini のシステム指示(5部構成の形式とウェブ検索を強制)
- codex.md - Codex のシステム指示(リポジトリを考慮した分析を強制)
- .geminiignore -
.gitignoreを超えるプライバシー除外設定 - 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:
- CLI がインストールされていない:
gemini: command not found→ 対処法:bun add -g @google/generative-ai-cli - API キーが無効:認証に失敗する → 対処法:
export GEMINI_API_KEY="..." - コンテキストが大きすぎる:トークン上限を超過する → 対処法:リポジトリ全体ではなく、特定のファイルを使用してください
- プライバシー情報の漏えい:
.envファイルが送信される → 対処法:.gitignoreと.geminiignoreに追加してください - スキルが見つからない:動作しない → 対処法:
~/.claude/skills/multi-ai-consultantを確認してください
トークン効率
このスキルを使わない場合
典型的な状況(バグで行き詰まった場合):
- アプローチ 1 を試す(約 4k トークン)
- CLI の構文を調べる(約 3k トークン)
- アプローチ 2 を試す(約 4k トークン)
- ドキュメントを調べる(約 3k トークン)
- アプローチ 3 を試す(約 4k トークン)
合計:約 20k トークン、30~45 分
このスキルを使う場合
同じ状況:
- アプローチ 1 を試す(約 4k トークン)
/consult-geminiを実行する(約 1k トークン)- Gemini が問題を見つける(5k トークン未満、別途請求)
- 修正を実装する(約 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、npm | CLI のみ |
最良の選択: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 - 実際の相談でテストしてください
- 改善前後の品質を測定してください
参考資料
外部リソース
- Gemini CLI:https://ai.google.dev/gemini-api/docs/cli
- OpenAI Codex:https://www.npmjs.com/package/codex
- OpenAI API:https://platform.openai.com/docs
- Gemini API の料金:https://ai.google.dev/pricing
- OpenAI の料金:https://openai.com/pricing
内部ファイル
- 計画ドキュメント:
planning/multi-ai-consultant-*.md - スラッシュコマンド:
commands/*.md - テンプレート:
templates/* - スクリプト:
scripts/* - 参考資料:
references/*.md(参考ファイル 5 件)
ライセンス
MIT License - LICENSE ファイルを参照してください
最終更新日:2025-11-07 ステータス:本番環境で利用可能 メンテナー:Claude Skills Maintainers | [email protected]