プラグインは、互換性のある Copilot サーフェス向けのカスタマイズをパッケージ化します。 プラグインの形式、コンポーネント、サポートされる場所は、サーフェスによって異なります。 プラグインをインストールする予定のインストール先のドキュメントを使用します。
プラグインマニフェスト
プラグインは、 plugin.json マニフェストによって記述されます。 エージェント プラグインは、対応する環境向けのポータブル プラグイン形式を定義します。 マニフェストはプラグイン ディレクトリのルートにあり、Agent Plugins スキーマを宣言します。 エージェント プラグイン 1.0 の場合は、 https://agent-plugins.org/schemas/1.0.0/plugin.schema.jsonを使用します。
Copilot CLI は 1.1.0 スキーマも認識します。
共有エージェント プラグイン形式は、一部のコンポーネントの標準の場所を定義します。 これらのコンポーネントのサポートは、サーフェスによって異なる場合があります。
| コンポーネント | エージェント プラグインの場所 | 備考 |
|---|---|---|
| Skills | skills/ | 互換性のあるデバイスは、この場所でスキルを見つけられます。 |
| MCP サーバー | ||
mcp.json プラグインのルート | 互換性のあるクライアントは、この場所で MCP サーバー構成を検出できます。 | |
| サーフェス固有のコンポーネント | ||
com.github.copilot/ のような名前空間付きディレクトリ | 提供状況とサポートされるコンポーネントは、Surface によって異なります。 |
エージェント プラグイン 1.0 ディレクトリでは、次の構造を使用できます。
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
plugin.json マニフェストは、エージェント プラグイン スキーマを宣言します。
skills/とルートのmcp.jsonの場所は、エージェント プラグインによって定義されます。
com.github.copilot/ ディレクトリには、移植可能なエージェント プラグイン コンポーネントではなく、Copilot固有のコンポーネントが含まれています。 このディレクトリからサーフェスが読み込むコンポーネントは、そのサーフェスによって異なります。
Copilot CLIについては、「GitHub Copilot CLI プラグイン リファレンス」を参照してください。
Copilot CLI また、従来の Copilot プラグイン形式もサポートしています。 これは、さまざまなコンポーネント検出動作と構成可能なコンポーネント パスを使用します。 マニフェスト フィールド、検証、ファイルの場所、CLI 固有の動作については、 GitHub Copilot CLI プラグイン リファレンス を参照してください。
Visual Studio Code では、プラグインのオーサリング形式とサポートされている動作を エージェント プラグインのオーサリング リファレンスで説明しています。 あるサーフェスでサポートされているコンポーネントまたはマニフェストの動作が、別のサーフェスでサポートされていると想定しないでください。
Marketplace カタログ
marketplace.json カタログは、マーケットプレースに関するメタデータを提供し、最上位レベルのplugins配列にプラグインを一覧表示します。 各プラグイン エントリには、その名前、説明、バージョン、ソースを含めることができます。 ソース元は、プラグイン ファイルが配置されている場所を示します。
Copilot CLIの場合、marketplace.jsonのみが必要な Marketplace コンポーネントです。 その他の画面には、追加要件が適用される場合があります。
マーケットプレース名は、リポジトリ名ではなく、name フィールドに由来します。 プラグイン識別子は、プラグイン名とマーケットプレース名を組み合わせたものになります。
PLUGIN-NAME@MARKETPLACE-NAME
設定で参照する場合は、マーケットプレース名とプラグイン名を変更しないようにします。 マーケットプレース名を変更すると、それらの設定で使用されるプラグイン識別子が変更されます。
カタログ フィールドとサポートされているファイルの場所は、サーフェスによって異なる場合があります。 Copilot CLIの完全なマーケットプレース カタログのフィールドと場所については、GitHub Copilot CLI プラグイン リファレンス を参照してください。 GitHub リポジトリにカタログを発行する手順については、GitHubでのプラグイン マーケットプレースの作成と共有 を参照してください。
プラグインを使用する
マーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。 プラグインをインストールすると、画面に追加されます。 プラグインを有効にすると、そのサーフェスでのセッションでそのコンポーネントを使用できるようになります。 サーフェス固有の手順については、次を参照してください。