mcpField
P
provider-integration

provider-integration

github.com/hexエージェントワークフロー91142 回インストール2 日前に更新
リポジトリ

provider-integration について

Claude Council に AI プロバイダーを追加するためのエージェントスキルです。Shell スクリプトのインターフェースや設定・テスト方法に加え、API と CLI の検出ルールを説明します。

主な機能

  1. 01Shell スクリプトのプロバイダー仕様
  2. 02API キーとモデルの設定
  3. 03CLI プロバイダーの検出ルール
  4. 04トラブルシューティングとテスト

活用シーン

  1. 01Claude Council への API プロバイダー追加
  2. 02CLI ベースのプロバイダー接続
  3. 03検出や呼び出し失敗の原因調査

インストール

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

$npx skills add https://github.com/hex/claude-council --skill provider-integration

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

同梱ファイルapi-patterns.md

詳細

Claude Council への AI プロバイダーの追加

プロバイダースクリプトのインターフェース

各プロバイダーは scripts/providers/ にあるシェルスクリプトで、次の要件を満たします。

  1. 最初の引数としてプロンプトを受け取る
  2. AI の応答を stdout に出力する
  3. 成功時は 0、失敗時は 0 以外で終了する

クイックスタート

  1. scripts/providers/{name}.sh を作成します（テンプレートについては api-patterns.md を参照してください）
  2. chmod +x scripts/providers/{name}.sh を実行します
  3. {NAME}_API_KEY 環境変数を設定します
  4. テストします：./scripts/providers/{name}.sh "Hello"

現在のプロバイダー

プロバイダーAPI キーの環境変数デフォルトモデル
GeminiGEMINI_API_KEYgemini-flash-latest
OpenAIOPENAI_API_KEYgpt-6-astra
GrokXAI_API_KEY（または GROK_API_KEY）grok-latest
PerplexityPERPLEXITY_API_KEYlow（Agent API プリセット）
KimiKIMI_API_KEYkimi-k3
Ollamaなし（ローカル）ollama list に表示される最初のモデル
OpenRouterOPENROUTER_API_KEYanthropic/claude-fable-5.1（または OPENROUTER_MODELS の各エントリに対応する 1 つの枠）

CLI プロバイダー（codex、antigravity、grok-cli、kimi-cli、cursor-cli）はキーを必要としません。バイナリが PATH 上にあれば検出され、その CLI 自身のログイン情報が使用されます。例外は claude-cli と copilot-cli です。claude はすべてのユーザーの PATH 上にあり、copilot で質問するたびにプレミアムリクエストを消費するため、どちらにも検出処理はなく、それぞれ --providers または COUNCIL_PROVIDERS で指定された場合にのみ参加します。ヘッドレス実行パターンについては scripts/providers/kimi-cli.sh と cursor-cli.sh を参照してください。具体的には、読み取り専用モード、回答の解析元となる JSON 出力形式、明示的に *_CLI_MODEL を上書きした場合にのみ --model を指定する方法、そして API プロバイダーのリトライの代わりに run_with_deadline を使用する方法です。タイムアウトまたは失敗した CLI は、scripts/lib/cli-stderr.sh の cli_failure_message を通じてエラーを報告します。内容はタイムアウト、またはカラーコードを除去した CLI の stderr の末尾 500 バイトです。

トラブルシューティング

  • 検出されない：API キーが設定されていること、スクリプトに実行権限があることを確認してください
  • API エラー：キーを確認し、レート制限を確認して、モデル名が正しいことを確かめてください
  • 解析に失敗する：デバッグ用に echo "$RESPONSE" を追加し、応答形式を確認してください

参考資料

API パターンとコードテンプレートについては、このディレクトリの api-patterns.md を参照してください。

コメント

Markdown 対応