GitHub Copilot プラグインについて

プラグインは、再利用可能なエージェント、スキル、フック、および統合によって Copilot を拡張するインストール可能なパッケージです。

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

GitHub Copilot CLI は、すべての Copilot プランで使用できます。 組織から Copilot を受け取る場合は、組織の設定で Copilot CLI ポリシーを有効にする必要があります。

Copilot cloud agent は、すべての有料 Copilot プランで使用できます。

エージェントは、GitHubが所有し、明示的に無効にされているリポジトリを除き、マネージド ユーザー アカウントに格納されているすべてのリポジトリで使用できます。

GitHub Copilot app は、すべての Copilot プランで使用できます。
Sign up for Copilot

この記事で

プラグインは、カスタム Copilot 機能を配布する方法を提供します。 プラグインを使用して、Copilot、Copilot CLI、Copilot cloud agentなど、構成済みの一連の機能をGitHub Copilot appに追加できます。

プラグインとは何ですか?

  • Copilotの機能を拡張する再頒布可能パッケージ。
  • 1 つのインストール可能なユニット内のコンポーネントのバンドル。

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

プラグインには、次のコンポーネントの一部またはすべてを含めることができます。 これらのコンポーネントの場所は、プラグインの形式によって異なります。

  • カスタム エージェント — 特殊化された AI アシスタント (*.agent.md 内のファイルagents/)
  • Skills — 個別の呼び出し可能な機能 ( skills/の skills サブディレクトリ、 SKILL.md ファイルを含む)
  • Hooks — エージェントの動作をインターセプトするイベント ハンドラー (プラグイン ルートまたはhooks.jsonのhooks/ ファイル)
  • MCP サーバー構成 — モデル コンテキスト プロトコルの統合
  • LSP サーバー構成 — 言語サーバー プロトコルの統合 (プラグイン ルートまたはlsp.json内の.github/ ファイル)

プラグインの形式

Copilot では、次の 2 つのプラグイン形式がサポートされています。

  • エージェント プラグイン 1.0 は、互換性のあるクライアント間でスキルと MCP サーバー構成を共有するための移植可能な形式です。 この形式を使用するには、plugin.jsonの$schemaをhttps://agent-plugins.org/schemas/1.0.0/plugin.schema.jsonに設定します。 スキルは skills/から検出され、MCP サーバーの構成はプラグイン ルートの mcp.json から検出されます。 これらの場所はマニフェストで構成できません。 スキルとMCPサーバーを移植可能にする場合は、エージェントプラグイン1.0を選択してください。
  • レガシ Copilot プラグインでは、 エージェント プラグインの $schemaは宣言されません。 構成可能なコンポーネント パス、 .mcp.json、 .github/mcp.json、または mcpServers マニフェスト フィールドの MCP 構成など、既存のマニフェスト フィールドとコンポーネント検出動作が使用されます。 構成可能なコンポーネント パスが必要な場合、または既存の Copilot固有のプラグインを維持している場合は、レガシ形式を選択します。

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

どちらの形式もサポートされています。 $schemaを追加すると、Copilotがマニフェストを解釈してコンポーネントを検出する方法が変わります。 $schemaのないプラグインは、引き続きレガシ プラグインとして読み込まれます。

プラグインの構造

プラグインは、特定の構造と 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 サーバーセットアップをカプセル化する

プラグインはどこで入手できますか?

プラグインは次の場所からインストールできます。

  • マーケットプレース
  • リポジトリ
  • ローカルな経路

マーケットプレースは、開発者がプラグインを公開、検出、インストール、管理できる場所です。 これはアプリ ストアに少し似ていますが、プラグインの場合です。

マーケットプレースの例を次に示します。

プラグインのインストール方法は、使用しているクライアントによって異なります。

  • Copilot CLIでは、copilot plugin install コマンドまたは /plugin install スラッシュ コマンドを使用してプラグインを命令的にインストールするか、ユーザー レベルのenabledPlugins ファイルまたはリポジトリ レベルの~/.copilot/settings.json ファイルの.github/copilot/settings.json フィールドにプラグインを追加することで、宣言によってプラグインをインストールできます。 「GitHub Copilot CLI のプラグインの検索とインストール」を参照してください。
  • Copilot cloud agentでは、プラグインをリポジトリのenabledPlugins ファイルの.github/copilot/settings.json フィールドに追加することで、宣言によってインストールします。 既定で登録されていないマーケットプレースからプラグインをインストールするには、同じファイルの extraKnownMarketplaces フィールドにマーケットプレースを追加することもできます。
  • GitHub Copilot appで、[カスタマイズ] をクリックし、[プラグイン] をクリックしてマーケットプレースを参照し、プラグインをインストールします。

エンタープライズ管理者は、企業の Copilot プランのユーザーに適用されるプラグイン標準を定義できます。これには、自動的にインストールされる追加のマーケットプレースとプラグインの指定が含まれます。 「エンタープライズで管理されるプラグインの標準について」を参照してください。

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

プラグイン マーケットプレースは、参照してインストールできるプラグインのレジストリです。 マーケットプレースは、 GitHub.com上のリポジトリ、他のオンライン Git ホスティング サービス、またはローカルまたは共有ファイル システムでホストできます。

マーケットプレースは、マーケットプレースに関するメタデータを提供し、利用可能なプラグインを一覧表示する marketplace.json ファイルによって定義されます。 マーケットプレースの plugins 配列内の各エントリには、プラグインの名前、説明、バージョン、プラグインのディレクトリへのパスなど、プラグインが記述されています。

マーケットプレースのプラグインはバージョン管理されているため、マーケットプレースではプラグインの検出、インストール、更新、チーム間での共有を簡単に行うことができます。 マーケットプレースの作成に関する詳細なガイダンスについては、 用のプラグイン マーケットプレースを作成する GitHub Copilot CLI を参照してください。

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

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

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

詳細については、次を参照してください。