mcpField
A
azure-hosted-copilot-sdk

azure-hosted-copilot-sdk

公式
github.com/microsoftクラウド・DevOps1.6k412.6k 回インストール今日更新
リポジトリ

azure-hosted-copilot-sdk について

Azure を対象とする GitHub Copilot SDK アプリのルーティングと実装を支援するスキルです。SDK の検出からスキャフォールディングや統合、モデル設定まで案内し、Azure の準備・デプロイ用スキルを連携します。

主な機能

  1. 01Copilot SDK コードベースの検出
  2. 02プロジェクトのスキャフォールディングと統合
  3. 03GitHub または Azure モデルの設定
  4. 04Azure の準備とデプロイの連携
  5. 05対応する Azure BYOM 認証情報の必須化

活用シーン

  1. 01新しい Copilot SDK サービスの Azure 対応
  2. 02既存リポジトリへの SDK サービス追加
  3. 03既存 SDK アプリの変更またはデプロイ

インストール

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

$npx skills add https://github.com/microsoft/azure-skills --skill azure-hosted-copilot-sdk

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

同梱ファイル

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

references/
auth-best-practices.md
azure-model-config.md
copilot-sdk.md
deploy-existing.md
existing-project-integration.md

詳細

Azure 上の GitHub Copilot SDK

コードベースの検出 — 最初に必ず実施するチェック

⚠️ 重要：既存のコードベースがある場合、ほかのスキル（azure-prepare、azure-deploy など）を実行する前に、このチェックを必ず実行してください。

検出手順（ビルド／変更／機能追加／準備のプロンプトでは、ただちに実行してください）：
  1. ワークスペースのルートにある package.json と、1階層下にある任意の */package.json を読み込みます
  2. name、dependencies、devDependencies に @github/copilot-sdk または copilot-sdk が含まれているか確認します
  3. package.json で見つからない場合は、.ts および .js ファイルをスキャンして CopilotClient または createSession を探します
  4. いずれかのマーカーが見つかった場合 → このスキルをエントリーポイントとして呼び出します。azure-prepare や azure-deploy に直接振り分けないでください。これらはこのスキルがサブスキルとしてオーケストレーションします。
マーカー確認場所
@github/copilot-sdkpackage.json の dependencies または devDependencies
copilot-sdkpackage.json の name または dependencies
CopilotClientソースファイル（.ts、.js）
createSession + sendAndWaitソースファイル（.ts、.js）
マーカーが検出された場合、このスキルを必ず実行する一般的なプロンプト：
プロンプトのパターン（「copilot」というキーワードを含まない）このスキルを使う理由
「このアプリをビルド」／「このアプリを Azure 向けに準備」コードベースに @github/copilot-sdk が含まれており、SDK を考慮したスキャフォールディングが必要です
「このアプリに新機能を追加」SDK を考慮した実装パターンが必要です
「このアプリを更新」／「このアプリを変更」SDK の統合パターンを維持する必要があります

⚠️ 警告： 既存のコードベースを対象とするビルド、変更、機能追加、準備のプロンプトは、プロンプトに「copilot」という記載がなくても、コードベースに @github/copilot-sdk が含まれている場合、必ずこのスキルに振り分けてください。その後、このスキルが azure-prepare と azure-deploy をサブスキルとしてオーケストレーションします。

⚠️ azure-deploy を優先： コードベースに .azure/deployment-plan.md がすでにあり、ユーザーがデプロイを希望している場合（変更や機能追加ではない場合）は、代わりに azure-deploy に振り分けてください。このスキルは準備を担当し、azure-deploy は実行を担当します。

ステップ 1：振り分け

ユーザーの要望アクション
新規構築（空のプロジェクト）ステップ 2A（スキャフォールド）
既存のリポジトリに新しい SDK サービスを追加ステップ 2B（並行してスキャフォールド）
既存の SDK アプリを Azure にデプロイステップ 2C（既存の SDK アプリにインフラを追加）
既存の SDK アプリを変更／機能追加コードベースのコンテキストと SDK リファレンスを使って実装
既存のアプリのコードに SDK を追加SDK を統合
Azure／独自のモデルを使用ステップ 3（BYOM 設定）

ステップ 2A：新規スキャフォールド（グリーンフィールド）

azd init --template azure-samples/copilot-sdk-service

テンプレートには API（Express/TS）+ Web UI（React/Vite）+ インフラ（Bicep）+ Dockerfiles + トークンスクリプトが含まれています。再作成しないでください。詳細は SDK リファレンス を参照してください。

ステップ 2B：既存のリポジトリに SDK サービスを追加

ユーザーは既存のコードを持ち、それと並行して新しい Copilot SDK サービスを追加しようとしています。テンプレートを一時ディレクトリにスキャフォールドし、API サービスとインフラをユーザーのリポジトリにコピーして、既存サービスと新規サービスの両方を含むように azure.yaml を調整します。詳細は 既存環境へのデプロイに関するリファレンス を参照してください。

ステップ 2C：既存の SDK アプリをデプロイ

ユーザーはすでに動作する Copilot SDK アプリを持っており、Azure インフラを必要としています。詳細は 既存環境へのデプロイに関するリファレンス を参照してください。

ステップ 3：モデルの構成

3 つのモデルパス（2A／2B の上に重ねるレイヤー）：

パス構成
GitHub のデフォルトmodel パラメーターなし — SDK がデフォルトを選択します
GitHub の特定モデルmodel: "<name>" — listModels() を使用して検出します
Azure BYOMDefaultAzureCredential を介した bearerToken とともに model + provider を指定します

⚠️ BYOM 認証 — 必須：Azure BYOM の構成では、DefaultAzureCredential（ローカル開発）または ManagedIdentityCredential（本番環境）を使用して bearerToken を取得する必要があります。サポートされている唯一の認証パターンは、プロバイダー構成の bearerToken です。認証情報のパターンについては認証のベストプラクティス、BYOM のコード例全体についてはモデル構成リファレンスを参照してください。

モデル構成リファレンスを参照してください。

ステップ 4：デプロイ

azure-prepare（スキャフォールディングは完了しているため、そのステップ 0 のルーティングはスキップします）→ azure-validate → azure-deploy の順に実行します。

ルール

  • 変更を加える前に、ユーザーのリポジトリにある AGENTS.md を読みます
  • Docker が必要です（docker info）
  • BYOM 認証：DefaultAzureCredential または ManagedIdentityCredential を介した bearerToken のみがサポートされています。他の認証パターンはサポートされていません

コメント

Markdown 対応