Skip to main content

GitHub Copilot プラグインについて

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

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

GitHub Copilot CLI(コマンドラインインターフェース) は、すべての Copilot プランで使用できます。 組織から Copilot を受け取る場合は、組織の設定で Copilot CLI (コパイロット CLI) ポリシーを有効にする必要があります。

Copilot クラウドエージェント は、すべての有料 Copilot プランで使用できます。

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

プラグインは、カスタム Copilot 機能を配布する方法を提供します。 プラグインを使用して、CopilotやCopilot CLI (コパイロット CLI)など、構成済みの一連の機能をCopilot クラウドエージェントに追加できます。

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

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

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

プラグインには、次のコンポーネントの一部またはすべてを含めることができます。

  • カスタム エージェント — 特殊化された AI アシスタント (*.agent.md 内のファイルagents/)
  • Skills — 個別の呼び出し可能な機能 ( skills/の skills サブディレクトリ、 SKILL.md ファイルを含む)
  • Hooks — エージェントの動作をインターセプトするイベント ハンドラー (プラグイン ルートまたはhooks.jsonhooks/ ファイル)
  • 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 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 エントリをインストールする
VersioningGit 履歴マーケットプレイスバージョン
Discoveryリポジトリの検索マーケットプレイスの閲覧

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