プラグインは、カスタム Copilot 機能を配布する方法を提供します。 プラグインを使用して、CopilotやCopilot CLI (コパイロット CLI)など、構成済みの一連の機能をCopilot クラウドエージェントに追加できます。
プラグインとは何ですか?
- Copilotの機能を拡張する再頒布可能パッケージ。
- 1 つのインストール可能なユニット内のコンポーネントのバンドル。
プラグインに含まれるもの
プラグインには、次のコンポーネントの一部またはすべてを含めることができます。
- カスタム エージェント — 特殊化された AI アシスタント (
*.agent.md内のファイルagents/) - Skills — 個別の呼び出し可能な機能 (
skills/の skills サブディレクトリ、SKILL.mdファイルを含む) - Hooks — エージェントの動作をインターセプトするイベント ハンドラー (プラグイン ルートまたは
hooks.jsonのhooks/ファイル) - MCP サーバー構成 — モデル コンテキスト プロトコル統合 (プラグイン ルートの
.mcp.jsonファイル、またはmcp.jsonの.github/ファイル) - LSP サーバー構成 — 言語サーバー プロトコルの統合 (プラグイン ルートまたは
lsp.json内の.github/ファイル)
プラグインの構造
プラグインは、特定の構造を持つディレクトリです。 少なくとも、ディレクトリのルートに plugin.json マニフェスト ファイルが含まれています。 マニフェストはプラグインに名前を付け、プラグインが提供するコンポーネントを指します。 マニフェストと共に、ディレクトリにはエージェント、スキル、フック、MCP サーバー構成、LSP サーバー構成の任意の組み合わせを含めることができます。
一般的なプラグイン ディレクトリは次のようになります。
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-plugins (既定で追加)
- awesome-copilot (既定で追加)
- claude-code-plugins
- claudeforge-marketplace
プラグインのインストール方法は、使用しているクライアントによって異なります。
- Copilot CLI (コパイロット CLI)では、
copilot plugin installコマンドまたは/plugin installスラッシュ コマンドを使用してプラグインを命令的にインストールするか、ユーザー レベルのenabledPluginsファイルまたはリポジトリ レベルの~/.copilot/settings.jsonファイルの.github/copilot/settings.jsonフィールドにプラグインを追加することで、宣言によってプラグインをインストールできます。 「GitHub Copilot CLI(コマンドラインインターフェース) のプラグインの検索とインストール」を参照してください。 - Copilot クラウドエージェントでは、プラグインをリポジトリの
enabledPluginsファイルの.github/copilot/settings.jsonフィールドに追加することで、宣言によってインストールします。 既定で登録されていないマーケットプレースからプラグインをインストールするには、同じファイルのextraKnownMarketplacesフィールドにマーケットプレースを追加することもできます。
エンタープライズ管理者は、企業の Copilot プランのユーザーに適用されるプラグイン標準を定義できます。これには、自動的にインストールされる追加のマーケットプレースとプラグインの指定が含まれます。 「エンタープライズで管理されるプラグインの標準について」を参照してください。
プラグイン マーケットプレースのしくみ
プラグイン マーケットプレースは、参照してインストールできるプラグインのレジストリです。 マーケットプレースは、 GitHub.com上のリポジトリ、他のオンライン Git ホスティング サービス、またはローカルまたは共有ファイル システムでホストできます。
マーケットプレースは、マーケットプレースに関するメタデータを提供し、利用可能なプラグインを一覧表示する marketplace.json ファイルによって定義されます。 マーケットプレースの plugins 配列内の各エントリには、プラグインの名前、説明、バージョン、プラグインのディレクトリへのパスなど、プラグインが記述されています。
マーケットプレースのプラグインはバージョン管理されているため、マーケットプレースではプラグインの検出、インストール、更新、チーム間での共有を簡単に行うことができます。 マーケットプレースの作成に関する詳細なガイダンスについては、 用のプラグイン マーケットプレースを作成する GitHub Copilot CLI(コマンドラインインターフェース) を参照してください。
プラグインと手動構成の比較
プラグインを使用して追加できる機能は、カスタム エージェント プロファイルや MCP サーバーを追加するなどして、 Copilot を手動で構成して追加することもできます。 ただし、プラグインは手動構成よりもいくつかの利点を提供します。
| 特徴 | リポジトリ内の手動構成 | プラグイン |
|---|---|---|
| Scope | 単一リポジトリ | 任意のプロジェクト |
| 共有 | 手動コピー/貼り付け | コマンドまたは enabledPlugins エントリをインストールする |
| Versioning | Git 履歴 | マーケットプレイスバージョン |
| Discovery | リポジトリの検索 | マーケットプレイスの閲覧 |