# プラグインとマーケットプレースのリファレンス

共有のプラグイン関連用語、マーケットプレースの用語、ファイル形式、およびサーフェス固有のドキュメントへのリンクを見つけます。

プラグインは、互換性のある Copilot サーフェス向けのカスタマイズをパッケージ化します。 プラグインの形式、コンポーネント、サポートされる場所は、サーフェスによって異なります。 プラグインをインストールする予定のインストール先のドキュメントを使用します。

## プラグインマニフェスト

プラグインは、 `plugin.json` マニフェストによって記述されます。 エージェント プラグインは、対応する環境向けのポータブル プラグイン形式を定義します。 マニフェストはプラグイン ディレクトリのルートにあり、Agent Plugins スキーマを宣言します。 エージェント プラグイン 1.0 の場合は、 `https://agent-plugins.org/schemas/1.0.0/plugin.schema.json`を使用します。
Copilot CLI は 1.1.0 スキーマも認識します。

共有エージェント プラグイン形式は、一部のコンポーネントの標準の場所を定義します。 これらのコンポーネントのサポートは、サーフェスによって異なる場合があります。

| コンポーネント                                | エージェント プラグインの場所                         | 備考                            |
| -------------------------------------- | --------------------------------------- | ----------------------------- |
| Skills                                 | `skills/NAME/SKILL.md`                  | 互換性のあるデバイスは、この場所でスキルを見つけられます。 |
| MCP サーバー                               |                                         |                               |
| `mcp.json` プラグインのルート                   | 互換性のあるクライアントは、この場所で MCP サーバー構成を検出できます。  |                               |
| サーフェス固有のコンポーネント                        |                                         |                               |
| `com.github.copilot/` のような名前空間付きディレクトリ | 提供状況とサポートされるコンポーネントは、Surface によって異なります。 |                               |

エージェント プラグイン 1.0 ディレクトリでは、次の構造を使用できます。

```text
my-plugin/
├── plugin.json
├── skills/
│   └── deploy/
│       └── SKILL.md
├── mcp.json
└── com.github.copilot/
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json
```

`plugin.json` マニフェストは、エージェント プラグイン スキーマを宣言します。
`skills/`とルートの`mcp.json`の場所は、エージェント プラグインによって定義されます。
`com.github.copilot/` ディレクトリには、移植可能なエージェント プラグイン コンポーネントではなく、Copilot固有のコンポーネントが含まれています。 このディレクトリからサーフェスが読み込むコンポーネントは、そのサーフェスによって異なります。
Copilot CLIについては、「[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference#components)」を参照してください。

Copilot CLI また、従来の Copilot プラグイン形式もサポートしています。 これは、さまざまなコンポーネント検出動作と構成可能なコンポーネント パスを使用します。 マニフェスト フィールド、検証、ファイルの場所、CLI 固有の動作については、 [GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference) を参照してください。

Visual Studio Code では、プラグインのオーサリング形式とサポートされている動作を [エージェント プラグインのオーサリング リファレンス](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference)で説明しています。 あるサーフェスでサポートされているコンポーネントまたはマニフェストの動作が、別のサーフェスでサポートされていると想定しないでください。

## Marketplace カタログ

`marketplace.json` カタログは、マーケットプレースに関するメタデータを提供し、最上位レベルの`plugins`配列にプラグインを一覧表示します。 各プラグイン エントリには、その名前、説明、バージョン、ソースを含めることができます。 ソース元は、プラグイン ファイルが配置されている場所を示します。
Copilot CLIの場合、`marketplace.json`のみが必要な Marketplace コンポーネントです。 その他の画面には、追加要件が適用される場合があります。

マーケットプレース名は、リポジトリ名ではなく、`name` フィールドに由来します。 プラグイン識別子は、プラグイン名とマーケットプレース名を組み合わせたものになります。

```text
PLUGIN-NAME@MARKETPLACE-NAME
```

設定で参照する場合は、マーケットプレース名とプラグイン名を変更しないようにします。 マーケットプレース名を変更すると、それらの設定で使用されるプラグイン識別子が変更されます。

カタログ フィールドとサポートされているファイルの場所は、サーフェスによって異なる場合があります。
Copilot CLIの完全なマーケットプレース カタログのフィールドと場所については、[GitHub Copilot CLI プラグイン リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson) を参照してください。
GitHub リポジトリにカタログを発行する手順については、[GitHubでのプラグイン マーケットプレースの作成と共有](/ja/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces) を参照してください。

## プラグインを使用する

マーケットプレースを追加すると、そのマーケットプレースのプラグインを参照できるようになります。 プラグインをインストールすると、画面に追加されます。 プラグインを有効にすると、そのサーフェスでのセッションでそのコンポーネントを使用できるようになります。 サーフェス固有の手順については、次を参照してください。

* [Visual Studio Code でプラグインを使用する](/ja/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [GitHub Copilot CLI のプラグインの検索とインストール](/ja/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [GitHub Copilot アプリのカスタマイズ](/ja/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [クラウドで GitHub Copilot の設定を行う](/ja/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)