{"meta":{"title":"GitHub Copilot 用のプラグイン","intro":"プラグインは関連するカスタマイズをパッケージ化するので、サポートされている Copilot 対応する環境全体にまとめてインストールできます。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/concepts","title":"概念"},{"href":"/ja/copilot/concepts/customizations","title":"カスタマイズ"},{"href":"/ja/copilot/concepts/customizations/plugins","title":"Plugins"}],"documentType":"article"},"body":"# GitHub Copilot 用のプラグイン\n\nプラグインは関連するカスタマイズをパッケージ化するので、サポートされている Copilot 対応する環境全体にまとめてインストールできます。\n\nプラグインは関連するカスタマイズをパッケージ化するので、それぞれを個別に設定する代わりに、それらを一緒にインストールして管理することができます。 たとえば、テスト プラグインでは、テストを実行するためのスキル、コード レビュー用のエージェント、テスト レポート サービス用の MCP サーバーを組み合わせることができます。\n\n## プラグインを使用できる場所\n\nプラグインは、次の Copilot サーフェスで使用できます。\n\n* Visual Studio Code。 \\[チャット] サイド パネルまたは \\[エージェント] ウィンドウの **\\[カスタマイズ]** からプラグインを参照してインストールします。 VS Code プラグインの形式の詳細については、 [エージェント プラグインの作成に関するリファレンスを参照してください](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference)。\n* GitHub Copilot CLI。 登録済みのマーケットプレースからプラグインを参照してインストールします。\n* GitHub Copilot app。\n  **カスタマイズ**からプラグインを参照してインストールできます。\n* Copilot in the cloud。 リポジトリ設定からプラグインを設定します。\n\nプラグインには、特定のサーフェスでのみ機能するコンポーネントを含めることができます。 プラグインが使用しているサーフェスに対応していることを確認します。 たとえば、このカテゴリで説明されている LSP サーバー構成は、Copilot CLI 向けです。 詳細については、「[プラグインとマーケットプレースのリファレンス](/ja/copilot/reference/plugin-and-marketplace-reference)」を参照してください。\n\n## プラグインに含まれるもの\n\nプラグインは、これらのコンポーネントの一部またはすべてをパッケージ化できます。 使用可能なコンポーネントとその場所は、プラグインの形式とサーフェスによって異なります。\n\n* **カスタム エージェント** — 特殊化された AI アシスタント (`*.agent.md` 内のファイル`agents/`)\n* **Skills** — タスク固有の命令、スクリプト、およびリソース (`SKILL.md` 内のスキル サブディレクトリで、`skills/` ファイルを含む)\n* **フック** — エージェント アクションに応答するイベント ハンドラー（プラグイン ルートまたは`hooks.json`内の`hooks/`ファイル）\n* **拡張機能** — ツールやスラッシュ コマンドなどの機能を追加するSurface固有のコード\n* **MCP サーバー構成** — モデル コンテキスト プロトコル統合 (エージェント プラグイン 1.0 のルート `mcp.json` )\n* **LSP サーバー構成** — サポートされているサーフェスでの言語サーバー プロトコルの統合\n\n## プラグインの形式\n\nエージェント プラグインは、互換性のあるサーフェス間でプラグイン マニフェスト、スキル、および MCP サーバー構成を共有するための形式です。 エージェント プラグイン 1.0 プラグインは、 `plugin.json`で正規スキーマを宣言します。そのスキーマとコンポーネントの場所は、すべてのサーフェスで同じ方法でサポートされているわけではありません。\nCopilot CLI また、従来の Copilot プラグイン形式もサポートしています。 CLI では、エージェント プラグイン スキーマを含まないマニフェストでは、このレガシ形式が使用されます。\n\n互換性のあるサーフェス間でスキルと MCP サーバーを共有する場合は、エージェント プラグインを選択します。 構成可能なコンポーネント パスが必要な場合、または既存のCopilot固有のプラグインを維持している場合は、従来の CLI 形式を使用します。\n\n新しいプラグインの場合は、構成可能なコンポーネント パスが必要な場合を除き、エージェント プラグイン 1.0 を使用します。 従来の形式は、主に既存のレガシ プラグインに使用します。\n\n## プラグインの構造\n\nプラグインは、特定の構造と `plugin.json` マニフェスト ファイルを持つディレクトリです。 エージェント プラグイン 1.0 では、プラグイン のルートにあるマニフェストが必要です。 従来のプラグインでは、追加のマニフェストの場所がサポートされています。 マニフェストはプラグインに名前とメタデータを提供します。 形式によっては、コンポーネントを指すこともできます。 マニフェストと共に、ディレクトリにはエージェント、スキル、フック、MCP サーバー構成、LSP サーバー構成を含めることができます。\n\n### エージェント プラグイン 1.0 の構造\n\nエージェント プラグイン 1.0 では、スキルと MCP サーバーが標準の場所に格納されるため、互換性のあるクライアントはそれらを検出できます。 エージェント、フック、コマンド、LSP サーバーなど、その他のコンポーネントはクライアント固有です。\nCopilot は、 `com.github.copilot` ディレクトリからこれらのコンポーネントを読み取ります。 他のクライアントはこのディレクトリを無視するため、同じプラグインで共有スキルと MCP サーバーを Copilot固有のコンポーネントと組み合わせることができます。\n\nエージェント プラグイン 1.0 ディレクトリは次のようになります。\n\n```text\nmy-plugin/\n├── plugin.json               # Required manifest\n├── skills/                   # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── mcp.json                  # MCP server config (optional)\n└── com.github.copilot/       # Copilot components (optional)\n    ├── agents/\n    │   └── helper.agent.md\n    ├── commands/\n    ├── rules/\n    ├── hooks/\n    │   └── hooks.json\n    └── lsp.json\n```\n\nマニフェストには、エージェント プラグイン 1.0 `$schema`が含まれている必要があります。 サポートされている最上位レベルのマニフェスト フィールド、名前の要件、コンポーネントの場所については、「 [エージェント プラグイン 1.0 マニフェスト フィールド](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields)」を参照してください。\n\n### 従来のプラグイン構造\n\n従来の Copilot プラグイン ディレクトリは次のようになります。\n\n```text\nmy-plugin/\n├── plugin.json           # Required manifest\n├── agents/               # Custom agents (optional)\n│   └── helper.agent.md\n├── skills/               # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── hooks.json            # Hook configuration (optional)\n├── .mcp.json             # MCP server config (optional)\n└── lsp.json              # LSP server config (optional)\n```\n\nマニフェストに含めることができるフィールドの完全なセットについては、 [GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference) を参照してください。 プラグインの作成に関する詳細なガイダンスについては、 [用のプラグインを作成する GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating) を参照してください。\n\n## プラグインを使用する理由\n\nプラグインには、次の利点があります。\n\n* プロジェクト間の再利用性\n* リポジトリ間での共有 Copilot 構成\n* ドメインの専門知識を共有する (Rails エキスパートや Kubernetes エキスパートのスキルを提供するなど)\n* 複雑な MCP サーバーセットアップをカプセル化する\n\n## プラグインの入手元\n\nVisual Studio Code、Copilot CLI、GitHub Copilot appの組み込みマーケットプレースは[awesome-copilot](https://github.com/github/awesome-copilot?utm_source=customization-plugin-doc-awesome\\&utm_medium=docs\\&utm_campaign=universe-2026)。 プラグインを利用できるようにするには、他のマーケットプレースを追加する必要があります。\n\nマーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。 それによってインストールや有効化は行われません。 プラグインの識別子は、プラグイン名とマーケットプレース名を組み合わせたものです: `PLUGIN-NAME@MARKETPLACE-NAME` マーケットプレース名は、リポジトリ名ではなく、`name` ファイル内の `marketplace.json` フィールドから取得されます。\n\n## プラグインが有効かどうかを決める要素\n\nプラグインは、使用可能、インストール済み、または有効にできます。 マーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。 プラグインをインストールすると、サーフェスに追加され、有効にすると、そのサーフェス上のセッションでそのコンポーネントが使用できるようになります。 共有構成では、既定を設定するか、プラグインを有効にするかどうかを強制できます。\n\n| 構成元                 | Effect                                                                        | メンバーはプラグインをオフにできますか?                |\n| ------------------- | ----------------------------------------------------------------------------- | ----------------------------------- |\n| エンタープライズ管理設定        | サポートされている各サーフェスでプラグインを要求またはブロックします。                                           | No. 管理ポリシーが常に優先されます。                |\n| エンタープライズ チームが管理する設定 | エンタープライズ ベースライン上に重ねたエンタープライズ チーム ファイルの `enabledPlugins` を使用して、必要なプラグインを追加します。 | No. これらのエントリはポリシーによって管理されています。      |\n| リポジトリの既定値           | リポジトリで作業するすべてのユーザーに対してプラグインを有効にします。                                           | はい。サーフェスがローカル オーバーライドをサポートしている場合です。 |\n\nリポジトリの既定値では、プラグインは必須ではありません。 管理ポリシーによって有効化がブロックされているプラグインを有効にしたり、ポリシーで許可されていないマーケットプレースを使用したりすることはできません。 既定では、マネージド設定でオプションのプラグインを有効にすることはできません。 プラグインを必要とするか、ブロックするだけです。\n\nエンタープライズ チームのファイルは、エンタープライズ ベースラインにマネージド `enabledPlugins` エントリを追加します。 メンバーは、必要なプラグインをオフにできません。 「[エンタープライズ チームのエンタープライズ管理設定のオーバーライド](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/override-settings-for-teams)」を参照してください。\n\nリポジトリの既定値では、 `.github/copilot/settings.json`が使用されます。 構成とサーフェス固有のローカルオーバーライドについては、 [GitHub Copilot CLI の構成ディレクトリ](/ja/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson) を参照してください。\n\nエンタープライズ管理者は、必要またはブロックする追加のマーケットプレースとプラグインを指定できます。 「[エンタープライズ管理設定を使用したプラグインマーケットプレースとプラグインの管理](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/manage-plugin-marketplaces-and-plugins)」を参照してください。\n\n## プラグイン マーケットプレースのしくみ\n\nプラグイン マーケットプレースは、参照してインストールできるプラグインのレジストリです。 マーケットプレースは、 GitHub.com上のリポジトリ、別の Git ホスト、またはローカル ディレクトリでホストできます。 マーケットプレースのプラグインはバージョン管理されているため、マーケットプレースではプラグインを見つけること、インストール、更新が容易になります。\n\nマーケットプレースは、マーケットプレースに関するメタデータを提供し、そのプラグインを一覧表示する `marketplace.json` ファイルによって定義されます。\n\nプラグインを使用したり、GitHub リポジトリでマーケットプレースを公開したりするための対象サーフェスごとの手順については、「[参考資料](#further-reading)」を参照してください。\n\n## プラグインと手動構成の比較\n\nプラグインを使用して追加できる機能は、カスタム エージェント プロファイルや MCP サーバーを追加するなどして、 Copilot を手動で構成して追加することもできます。 ただし、プラグインは手動構成よりもいくつかの利点を提供します。\n\n| Feature    | リポジトリ内の手動構成 | プラグイン                                  |\n| ---------- | ----------- | -------------------------------------- |\n| Scope      | 単一リポジトリ     | 任意のプロジェクト                              |\n| 共有         | 手動コピー/貼り付け  | コマンドまたは `enabledPlugins` エントリをインストールする |\n| Versioning | Git 履歴      | マーケットプレイスバージョン                         |\n| 発見         | リポジトリの検索    | マーケットプレイスの閲覧                           |\n\n## 詳細については、次を参照してください。\n\n* [Visual Studio Code でプラグインを使用する](/ja/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)\n* [GitHub Copilot CLI のプラグインの検索とインストール](/ja/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)\n* [GitHub Copilot アプリのカスタマイズ](/ja/copilot/how-tos/github-copilot-app/customize-github-copilot-app#adding-plugins)\n* [クラウドで GitHub Copilot の設定を行う](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#configuring-plugins-for-github-copilot-cloud-agent)\n* [GitHubでのプラグイン マーケットプレースの作成と共有](/ja/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces)"}