GitHub Copilot 用のプラグイン

プラグインは関連するカスタマイズをパッケージ化するので、それぞれを個別に設定する代わりに、それらを一緒にインストールして管理することができます。たとえば、テストプラグインでは、テストを実行するためのスキル、コードレビュー用のエージェント、テストレポートサービス用の MCP サーバーを組み合わせることができます。

プラグインを使用できる場所

プラグインは、次の Copilot サーフェスで使用できます。

Visual Studio Code。 [チャット] サイドパネルまたは [エージェント] ウィンドウの [カスタマイズ] からプラグインを参照してインストールします。 VS Code プラグインの形式の詳細については、エージェントプラグインの作成に関するリファレンスを参照してください。
GitHub Copilot CLI。登録済みのマーケットプレースからプラグインを参照してインストールします。
GitHub Copilot app。 カスタマイズからプラグインを参照してインストールできます。
Copilot in the cloud。リポジトリ設定からプラグインを設定します。

プラグインには、特定のサーフェスでのみ機能するコンポーネントを含めることができます。プラグインが使用しているサーフェスに対応していることを確認します。たとえば、このカテゴリで説明されている LSP サーバー構成は、Copilot CLI 向けです。詳細については、「プラグインとマーケットプレースのリファレンス」を参照してください。

プラグインに含まれるもの

プラグインは、これらのコンポーネントの一部またはすべてをパッケージ化できます。使用可能なコンポーネントとその場所は、プラグインの形式とサーフェスによって異なります。

カスタムエージェント — 特殊化された AI アシスタント (*.agent.md 内のファイルagents/)
Skills — タスク固有の命令、スクリプト、およびリソース (SKILL.md 内のスキルサブディレクトリで、skills/ ファイルを含む)
フック — エージェントアクションに応答するイベントハンドラー（プラグインルートまたはhooks.json内のhooks/ファイル）
拡張機能 — ツールやスラッシュコマンド��どの機能を追加するSurface固有のコード
MCP サーバー構成 — モデルコンテキストプロトコル統合 (エージェントプラグイン 1.0 のルート mcp.json )
LSP サーバー構成 — サポートされているサーフェスでの言語サーバープロトコルの統合

エージェントプラグインは、互換性のあるサーフェス間でプラグインマニフェスト、スキル、および MCP サーバー構成を共有するための形式です。エージェントプラグイン 1.0 プラグインは、 plugin.jsonで正規スキーマを宣言します。そのスキーマとコンポーネントの場所は、すべてのサーフェスで同じ方法でサポートされているわけではありません。 Copilot CLI また、従来の Copilot プラグイン形式もサポートしています。 CLI では、エージェントプラグインスキーマを含まないマニフェストでは、このレガシ形式が使用されます。

互換性のあるサーフェス間でスキルと MCP サーバーを共有する場合は、エージェントプラグインを選択します。構成可能なコンポーネントパスが必要な場合、または既存のCopilot固有のプラグインを維持している場合は、従来の CLI 形式を使用します。

新しいプラグインの場合は、構成可能なコンポーネントパスが必要な場合を除き、エージェントプラグイン 1.0 を使用します。従来の形式は、主に既存のレガシプラグインに使用します。

プラグインの構造

プラグインは、特定の構造と plugin.json マニフェストファイルを持つディレクトリです。エージェントプラグイン 1.0 では、プラグインのルートにあるマニフェストが必要です。従来のプラグインでは、追加のマニフェストの場所がサポートされています。マニフェストはプラグインに名前とメタデータを提供します。形式によっては、コンポーネントを指すこともできます。マニフェストと共に、ディレクトリにはエージェント、スキル、フック、MCP サーバー構成、LSP サーバー構成を含めることができます。

エージェントプラグイン 1.0 の構造

エージェントプラグイン 1.0 では、スキルと MCP サーバーが標準の場所に格納されるため、互換性のあるクライアントはそれらを検出できます。エージェント、フック、コマンド、LSP サーバーなど、その他のコンポーネントはクライアント固有です。 Copilot は、 com.github.copilot ディレクトリからこれらのコンポーネントを読み取ります。他のクライアントはこのディレクトリを無視するため、同じプラグインで共有スキルと MCP サーバーを Copilot固有のコンポーネントと組み合わせることができます。

エージェントプラグイン 1.0 ディレクトリは次のようになります。

my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json

マニフェストには、エージェントプラグイン 1.0 $schemaが含まれている必要があります。サポートされている最上位レベルのマニフェストフィールド、名前の要件、コンポーネントの場所については、「エージェントプラグイン 1.0 マニフェストフィールド」を参照してください。

従来のプラグイン構造

従来の Copilot プラグインディレクトリは次のようになります。

my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)

マニフェストに含めることができるフィールドの完全なセットについては、 GitHub Copilot CLI プラグインリファレンスを参照してください。プラグインの作成に関する詳細なガイダンスについては、用のプラグインを作成する GitHub Copilot CLI を参照してください。

プラグインを使用する理由

プラグインには、次の利点があります。

プロジェクト間の再利用性
リポジトリ間での共有 Copilot 構成
ドメインの専門知識を共有する (Rails エキスパートや Kubernetes エキスパートのスキルを提供するなど)
複雑な MCP サーバーセットアップをカプセル化する

プラグインの入手元

Visual Studio Code、Copilot CLI、GitHub Copilot appの組み込みマーケットプレースはawesome-copilot。プラグインを利用できるようにするには、他のマーケットプレースを追加する必要があります。

マーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。それによってインストールや有効化は行われません。プラグインの識別子は、プラグイン名とマーケットプレース名を組み合わせたものです: PLUGIN-NAME@MARKETPLACE-NAME マーケットプレース名は、リポジトリ名ではなく、name ファイル内の marketplace.json フィールドから取得されます。

プラグインが有効かどうかを決める要素

プラグインは、使用可能、インストール済み、または有効にできます。マーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。プラグインをインストールすると、サーフェスに追加され、有効にすると、そのサーフェス上のセッションでそのコンポーネントが使用できるようになります。共有構成では、既定を設定するか、プラグインを有効にするかどうかを強制できます。

構成元	Effect	メンバーはプラグインをオフにできますか?
エンタープライズ管理設定	サポートされている各サーフェスでプラグインを要求またはブロックします。	No. 管理ポリシーが常に優先されます。
エンタープライズチームが管理する設定	エンタープライズベースライン上に重ねたエンタープライズチームファイルの `enabledPlugins` を使用して、必要なプラグインを追加します。	No. これらのエントリはポリシーによって管理されています。
リポジトリの既定値	リポジトリで作業するすべてのユーザーに対してプラグインを有効にします。	はい。サーフェスがローカルオーバーライドをサポートしている場合です。

リポジトリの既定値では、プラグインは必須ではありません。管理ポリシーによって有効化がブロックされているプラグインを有効にしたり、ポリシーで許可されていないマーケットプレースを使用したりすることはできません。既定では、マネージド設定でオプションのプラグインを有効にすることはできません。プラグインを必要とするか、ブロックするだけです。

エンタープライズチームのファイルは、エンタープライズベースラインにマネージド enabledPlugins エントリを追加します。メンバーは、必要なプラグインをオフにできません。「エンタープライズチームのエンタープライズ管理設定のオーバーライド」を参照してください。

リポジトリの既定値では、 .github/copilot/settings.jsonが使用されます。構成とサーフェス固有のローカルオーバーライドについては、 GitHub Copilot CLI の構成ディレクトリを参照してください。

エンタープライズ管理者は、必要またはブロックする追加のマーケットプレースとプラグインを指定できます。「エンタープライズ管理設定を使用したプラグインマーケットプレースとプラグインの管理」を参照してください。

プラグインマーケットプレースのしくみ

プラグインマーケットプレースは、参照してインストールできるプラグインのレジストリです。マーケットプレースは、 GitHub.com上のリポジトリ、別の Git ホスト、またはローカルディレクトリでホストできます。マーケットプレースのプラグインはバージョン管理されているため、マーケットプレースではプラグインを見つけること、インストール、更新が容易になります。

マーケットプレースは、マーケットプレースに関するメタデータを提供し、そのプラグインを一覧表示する marketplace.json ファイルによって定義されます。

プラグインを使用したり、GitHub リポジトリでマーケットプレースを公開したりするための対象サーフェスごと��手順については、「参考資料」を参照してください。

プラグインと手動構成の比較

プラグインを使用して追加できる機能は、カスタムエージェントプロファイルや MCP サーバーを追加するなどして、 Copilot を手動で構成して追加することもできます。ただし、プラグインは手動構成よりもいくつかの利点を提供します。

Feature	リポジトリ内の手動構成	プラグイン
Scope	単一リポジトリ	任意のプロジェクト
共有	手動コピー/貼り付け	コマンドまたは `enabledPlugins` エントリをインストールする
Versioning	Git 履歴	マーケットプレイスバージョン
発見	リポジトリの検索	マーケットプレイスの閲覧

この機能を使用できるユーザーについて

この記事で