# GitHub Copilot CLI プラグイン リファレンス

CLI プラグインのコマンドと構成の詳細を確認します。

> \[!NOTE]
> ターミナルで `copilot plugin [SUBCOMMAND] --help` を入力すると、プラグインの使用に関するヘルプが表示されます。

プラグインとは何か、および Copilot クライアント間での動作の概要については、 [GitHub Copilot プラグインについて](/ja/enterprise-cloud@latest/copilot/concepts/agents/about-plugins) を参照してください。

## CLI コマンド

ターミナルで次のコマンドを使用して、 Copilot CLIのプラグインを管理できます。
`copilot plugin` と `copilot plugins` は交換可能です。サブコマンドの方が読み取りが良い方を使用します。

| 命令                                                       | 説明                                                                                                    |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `copilot plugin install SPECIFICATION`                   | プラグインをインストールします。 以下[のコマンドについては、プラグインの仕様`install`](#plugin-specification-for-install-command)参照してください。 |
| `copilot plugin uninstall NAME`                          | プラグインを削除する                                                                                            |
| `copilot plugin list`                                    | インストールされているプラグインを一覧表示する                                                                               |
| `copilot plugin update NAME`                             | 名前付きプラグインを更新します。                                                                                      |
| `--all`を使用して、インストールされているすべてのプラグインを一度に更新します。              |                                                                                                       |
| `copilot plugin enable NAME`                             | 以前に無効にしたプラグインを有効にする                                                                                   |
| `copilot plugin disable NAME`                            | アンインストールせずにプラグインを無効にする                                                                                |
| `copilot plugin marketplace add SPECIFICATION`           | マーケットプレースを登録します。 マーケットプレースの独自の名前は、 `marketplace.json` マニフェストから登録キーになります。カスタム ローカル名を設定するオプションはありません。   |
| `copilot plugin marketplace list`                        | 登録されているマーケットプレースを一覧表示する                                                                               |
| `copilot plugin marketplace browse NAME`                 | Marketplace プラグインを参照する                                                                                |
| `copilot plugin marketplace update [NAME]`（別名 `refresh`） | マーケットプレースのプラグインカタログを再取得します。 登録されているすべてのマーケットプレースのカタログを更新するには、 `NAME` を省略します。                          |
| `copilot plugin marketplace remove NAME`                 | マーケットプレースの登録を解除します。 マーケットプレースからのプラグインがまだインストールされている場合は拒否されます。これらのプラグインをアンインストールするには、 `--force` を渡します。 |

非対話型、 `copilot plugins enable NAME --plugin`、 `copilot plugins disable NAME --plugin`、および `copilot plugins remove NAME --plugin` は、同じ有効化、無効化、アンインストール操作を提供します。
`--plugin` は既定の種類であり、これら 3 つのコマンドでは省略できます。 これらのコマンドを MCP サーバーとスキルに拡張する非対話型[](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#using-copilot-plugins-list)と`--mcp`の種類については、`--skill`参照してください。

> \[!NOTE]
> 組織または MDM 管理ポリシー (`enabledPlugins`、 `extraKnownMarketplaces`) によってピン留めされたプラグインまたはマーケットプレースは、そのエントリに対してマネージド値が優先され、ローカルで再有効化、無効化、または再ポイントすることはできません。
> `/plugin`ダッシュボードは、これらの行を`Managed`バッジでマークし、競合するトグルを拒否します。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#mdm-managed-settings)」を参照してください。

### `install` コマンドのプラグイン仕様

| フォーマット                        | 例                            | 説明                    |
| ----------------------------- | ---------------------------- | --------------------- |
| Marketplace                   | `plugin@marketplace`         | 登録済みマーケットプレースからのプラグイン |
| GitHub                        | `OWNER/REPO`                 |                       |
| GitHub リポジトリのルート              |                              |                       |
| GitHub  サブディレクトリ              | `OWNER/REPO:PATH/TO/PLUGIN`  | リポジトリ内のサブディレクトリ       |
| Git URL                       | `https://github.com/o/r.git` | 任意の Git URL           |
| ローカル パス                       |                              |                       |
| `./my-plugin` または `/abs/path` | ローカル ディレクトリ                  |                       |

### `copilot plugins install` のオプション

仕様からプラグインをインストールするだけでなく、 `copilot plugins install` は、 `--skill`を含むファイル、URL、またはディレクトリから個々のスキルをインストールできます。 スキルのインストールはプラグインのインストールではなく、マーケットプレースを経由しません。スキル自体の詳細については [、AUTOTITLE](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#skills-reference) を参照してください。

| Option                                                                                                         | 説明                                                       |
| -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `--plugin`                                                                                                     | プラグインをインストールします (既定)。                                    |
| `--skill`                                                                                                      | ローカル パスまたは URL からスキルをインストールします。                          |
| `--scope SCOPE`                                                                                                | インストール `--skill` ファイルまたは URL: `user` (既定) または `project`。 |
| `project` では、ユーザー アカウントではなく現在のリポジトリの `.github/skills` ディレクトリにインストールのスコープが設定され、ファイルまたは URL スキルのインストールにのみ適用されます。 |                                                          |
| `--config-dir=DIRECTORY`                                                                                       | 構成ディレクトリへのパス。 このオプションは非推奨です。                             |
| `COPILOT_HOME` を代わりに使用します。                                                                                     | <!-- markdownlint-disable-line GHD046 -->                |

ディレクトリをインストールすると、それをコピーするのではなく、カスタム スキル ソースとして登録します。ファイルまたは URL をインストールすると、スキルのコンテンツが個人またはプロジェクトのスキル ディレクトリにコピーされます。

MCP サーバーは、認証と対話型のシークレット エントリを必要とする、ポリシーで構成されたレジストリからインストールします。
`/plugin`または`/mcp` ダッシュボード (オンライン モード) を使用して、`copilot plugins install`ではなく MCP サーバーを追加します。

### `copilot plugins update` のオプション

| Option  | 説明                        |
| ------- | ------------------------- |
| `--all` | インストールされているすべてのプラグインを更新する |

> \[!NOTE]
> ローカルな（ディレクトリ ソースの）マーケットプレース内のパス指定のプラグインは、実際のディレクトリから直接ライブ読み込みされます。1 つを編集すると、その変更は `/restart` 時または新しいセッションで反映され、`copilot plugin update` は不要です。

組み込みの `copilot-plugins` および `awesome-copilot` マーケットプレースからインストールされたファースト パーティ プラグインは、信頼された作業ディレクトリ内の各セッションの開始時に自動的に更新されます。 この動作は、 `autoUpdate` 設定 ( `false` に設定) または `COPILOT_AUTO_UPDATE=false` 環境変数で無効にします。 CI では、自動更新も既定でスキップされます。 「[GitHub Copilot CLI の構成ディレクトリ](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings)」を参照してください。

自分で追加したマーケットプレースでは、ユーザー設定の`autoUpdate: true`エントリに`extraKnownMarketplaces`を設定することで、同じセッション開始自動更新をオプトインできます。 このオプトインは、対話型セッションと `-p` セッションにのみ適用されます。SDK セッションとサーバー セッションは自動更新されません。 独自のユーザー設定または管理対象 (MDM/サーバー) 設定から受け入れられますが、リポジトリ レベルの `autoUpdate` 設定は受け入れられ、無視されます。マーケットプレースの自動更新を有効またはリダイレクトすることはできません。 同じ名前の競合では、組み込みのファースト パーティ マーケットプレースが優先され、マネージド エントリ (同じ名前のユーザー エントリ全体が置き換えられるため、 `"autoUpdate": true` のないマネージド エントリによってユーザーのオプトインが削除されます)、その後、ユーザー自身のエントリが削除されます。
[「リポジトリの設定」を](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson)参照してください。

対話型モードでは、アップストリームで新しいバージョンが利用可能な場合、`/plugin` はインストール済みのプラグインまたはマーケットプレースが更新可能であることを示し、ダッシュボードからそれを取得するための **更新** アクションを提供します。

### `copilot plugins marketplace` サブコマンド

組み込みの既定のマーケットプレースにはランタイムが付属しており、削除することはできません。

| サブコマンド                        | 説明                                                              |
| ----------------------------- | --------------------------------------------------------------- |
| `list [--json]`               | 組み込みの既定値を含め、登録されているすべてのマーケットプレースを一覧表示する                         |
| `add SOURCE`                  | マーケットプレース (`owner/repo`、 `owner/repo#ref`、URL、またはローカル パス) を追加する |
| `remove NAME [--force]`       | マーケットプレースを削除する。 `--force` は、そこからソース化されたプラグインもアンインストールします        |
| `browse NAME [--json]`        | マーケットプレースのカタログによって提供されるプラグインを一覧表示する                             |
| `update [NAME]`（別名 `refresh`） | 1 つのマーケットプレースのプラグイン カタログを更新するか、 `NAME` を省略した場合はすべて更新する          |

対話型モードで、 `/plugin marketplace update [NAME]` (エイリアス `/plugin marketplace refresh`) を実行するか、プラグイン ダッシュボードの \[Marketplace] タブで `r` を押して、登録されているすべてのマーケットプレースのカタログを更新します。

## `plugin.json`

すべてのプラグインは、少なくともプラグインディレクトリのルートにある `plugin.json` という名前のマニフェストファイルを含むプラグインディレクトリで構成されています。 「[用のプラグインを作成する GitHub Copilot CLI](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating)」を参照してください。

### 必須フィールド

| フィールド                                                                                                  | タイプ | 説明                                          |
| ------------------------------------------------------------------------------------------------------ | --- | ------------------------------------------- |
| `name`                                                                                                 | 文字列 | Kebab-case プラグイン名 (文字、数字、ハイフンのみ)。 最大 64 文字。 |
| [Open Plugin Spec のサポート](#open-plugin-spec-support)をオプトインするプラグインでは、ドット (`acme.tools` など) を使用することもできます。 |     |                                             |

### 省略可能なメタデータ フィールド

| フィールド                                                           | タイプ       | 説明                                                                           |
| --------------------------------------------------------------- | --------- | ---------------------------------------------------------------------------- |
| `$schema`                                                       | 文字列       | 標準のエージェント プラグイン (Open Plugin Spec) v1.0.0 スキーマ URL に設定して、仕様セマンティクスをオプトインします。 |
| [Open Plugin Spec support](#open-plugin-spec-support)を参照してください。 |           |                                                                              |
| `description`                                                   | 文字列       | 簡単な説明。 最大 1024 文字。                                                           |
| `version`                                                       | 文字列       | セマンティック バージョン (例: `1.0.0`)。                                                  |
| `author`                                                        | オブジェクト    |                                                                              |
| `name` (必須)、 `email` (省略可能)、 `url` (省略可能)。                      |           |                                                                              |
| `homepage`                                                      | 文字列       | プラグインのホームページ URL。                                                            |
| `repository`                                                    | 文字列       | ソース リポジトリの URL。                                                              |
| `license`                                                       | 文字列       | ライセンス識別子 (例: `MIT`)。                                                         |
| `keywords`                                                      | string\[] | キーワードを検索します。                                                                 |
| `category`                                                      | 文字列       | プラグイン カテゴリ。                                                                  |
| `tags`                                                          | string\[] | その他のタグ。                                                                      |

### コンポーネント パス フィールド

これらは、プラグインのコンポーネントを見つける場所を CLI に指示します。 すべて省略可能です。 省略した場合、CLI では既定の規則が使用されます。

| フィールド                                                                 | タイプ                           | デフォルト     | 説明                                                                          |
| --------------------------------------------------------------------- | ----------------------------- | --------- | --------------------------------------------------------------------------- |
| `agents`                                                              | string \| string\[]           | `agents/` | エージェント ディレクトリ (`.agent.md` ファイル) へのパス。                                      |
| `skills`                                                              | string \| string\[]           | `skills/` | スキル ディレクトリ (`SKILL.md` ファイル) へのパス。                                          |
| `commands`                                                            | string \| string\[]           | —         | コマンド ディレクトリへのパス。                                                            |
| `hooks`                                                               | string \| オブジェクト              | —         | hooks 構成ファイルまたはインライン フック オブジェクトへのパス。                                        |
| `extensions`                                                          | string \| string\[] \| オブジェクト | —         | 拡張ディレクトリへのパス。 組み込みの拡張機能を抑制するには、 `{ paths: [...], exclusive: true }` を使用します。 |
| [Open Plugin Spec モード](#open-plugin-spec-support)では、このフィールドの意味は異なります。 |                               |           |                                                                             |
| `mcpServers`                                                          | string \| オブジェクト              | —         | MCP 構成ファイル (例: `.mcp.json`)、またはインライン サーバー定義へのパス。                            |
| `lspServers`                                                          | string \| オブジェクト              | —         | LSP 構成ファイルまたはインライン サーバー定義へのパス。                                              |

### `plugin.json` ファイルの例

```json copy
{
  "name": "my-dev-tools",
  "description": "React development utilities",
  "version": "1.2.0",
  "author": {
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "license": "MIT",
  "keywords": ["react", "frontend"],
  "agents": "agents/",
  "skills": ["skills/", "extra-skills/"],
  "hooks": "hooks.json",
  "mcpServers": ".mcp.json"
}
```

## Open Plugin Spec のサポート

`$schema`で正規の`plugin.json`を宣言すると、標準プラグインの読み込みに加えて、[プラグインが Agent Plugins (Open Plugin Spec)](https://agent-plugins.org) v1.0.0 形式にオプトされます。

### LSP サーバーの構成

プラグインに LSP (Language Server Protocol) サーバーを含めるには、プラグイン ディレクトリに`lsp-config/servers.json` ファイルを作成するか、`lspServers`の `plugin.json` フィールドを使用してパスまたはインライン オブジェクトを指定します。

`lsp-config/servers.json` の例 (または、`lspServers` の `plugin.json` を使用したインライン):

```json
{
    "lspServers": {
        "my-lsp": {
            "command": "my-language-server",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}
```

クロスプラットフォーム サポートの場合は、`bash`ではなく、`powershell`と`command`を使用します。

```json
{
    "lspServers": {
        "my-lsp": {
            "bash": "${PLUGIN_ROOT}/scripts/start-lsp.sh",
            "powershell": "${PLUGIN_ROOT}/scripts/start-lsp.ps1",
            "fileExtensions": { ".myext": "mylang" }
        }
    }
}
```

| フィールド                                         | タイプ       | 必須  | 説明                                                                 |
| --------------------------------------------- | --------- | --- | ------------------------------------------------------------------ |
| `command`                                     | 文字列       | \*  | 言語サーバーを起動する実行可能ファイル。                                               |
| `bash`                                        | 文字列       | \*  | サーバーを起動するための Bash スクリプト (Linux/macOS); `bash -c SCRIPT`を介して実行されます。 |
| `powershell`                                  | 文字列       | \*  | サーバー (Windows) を起動する PowerShell スクリプト。`pwsh -c SCRIPT` 経由で実行されます。  |
| `cwd`                                         | 文字列       | いいえ | 作業ディレクトリ。 構成ファイルに対する絶対または相対。                                       |
| `${PLUGIN_ROOT}` をサポートします。                    |           |     |                                                                    |
| `args`                                        | string\[] | いいえ |                                                                    |
| `command`に渡す引数 (`bash`と`powershell`では無視されます)。 |           |     |                                                                    |
| `env`                                         | オブジェクト    | いいえ | サーバーを生成するときに設定する環境変数。                                              |
| `fileExtensions`                              | オブジェクト    | はい  | ファイル拡張子を言語 ID にマップします (たとえば、 `{ ".ts": "typescript" }`)。           |
| `rootUri`                                     | 文字列       | いいえ | git のルートに対するプロジェクトのルート (既定値: `.`)。                                 |
| `initializationOptions`                       | 任意の       | いいえ | LSP `initialize` 要求でサーバーに送信されるオプション。                               |

(\*)少なくとも 1 つの `command`、 `bash`、または `powershell` が必要です。
`bash` と `powershell` の両方を指定すると、プラットフォームに適したオプションが自動的に選択されます (Windows の PowerShell、Bash の他の場所)。

`${PLUGIN_ROOT}`を使用して、プラグイン ディレクトリ内のパスを参照します。

## `marketplace.json`

`marketplace.json` ファイルを作成してリポジトリの `.github/plugin/` ディレクトリに保存すると、人々がプラグインを発見してインストールするのに利用できるプラグインマーケットプレースを作成できます。
`marketplace.json` ファイルをローカル ファイル システムに格納することもできます。 たとえば、ファイルを `/PATH/TO/my-marketplace/.github/plugin/marketplace.json` として保存すると、次のコマンドを使用して CLI に追加できます。

```shell
copilot plugin marketplace add /PATH/TO/my-marketplace
```

> \[!NOTE]
> Copilot CLI は、`marketplace.json` ディレクトリ内の`.claude-plugin/` ファイルも検索します。

詳細については、「[用のプラグイン マーケットプレースを作成する GitHub Copilot CLI](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace)」を参照してください。

### `marketplace.json` ファイルの例

```json copy
{
  "name": "my-marketplace",
  "owner": {
    "name": "Your Organization",
    "email": "plugins@example.com"
  },
  "metadata": {
    "description": "Curated plugins for our team",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "frontend-design",
      "description": "Create a professional-looking GUI ...",
      "version": "2.1.0",
      "source": "./plugins/frontend-design"
    },
    {
      "name": "security-checks",
      "description": "Check for potential security vulnerabilities ...",
      "version": "1.3.0",
      "source": "./plugins/security-checks"
    }
  ]
}
```

> \[!NOTE]
> 各プラグインの `source` フィールドの値は、リポジトリのルートを基準としたプラグインのディレクトリへのパスです。 パスの先頭で `./` を使用する必要はありません。 たとえば、`"./plugins/plugin-name"` と `"plugins/plugin-name"` は同じディレクトリに解決されます。

### `marketplace.json` フィールド

#### 最上位レベルのフィールド

| フィールド                                                                 | タイプ    | 必須  | 説明                                        |
| --------------------------------------------------------------------- | ------ | --- | ----------------------------------------- |
| `name`                                                                | 文字列    | はい  | Kebab-case のマーケットプレース名。 最大 64 文字。         |
| `acme.tools` プラグインでは、ドット ([](#open-plugin-spec-support)など) も受け入れられます。 |        |     |                                           |
| `owner`                                                               | オブジェクト | はい  |                                           |
| `{ name, email? }` — マーケットプレースの所有者情報。                                 |        |     |                                           |
| `plugins`                                                             | アレイ    | はい  | プラグイン エントリの一覧 (下の表を参照)。                   |
| `metadata`                                                            | オブジェクト | いいえ | `{ description?, version?, pluginRoot? }` |

#### プラグインエントリフィールド( `plugins` 配列内のオブジェクト)

| フィールド                                                        | タイプ                 | 必須  | 説明                                                                                                              |
| ------------------------------------------------------------ | ------------------- | --- | --------------------------------------------------------------------------------------------------------------- |
| `name`                                                       | 文字列                 | はい  | Kebab-case プラグイン名。 最大 64 文字。 ドットは、 [オープンプラグインスペック](#open-plugin-spec-support) プラグインでも受け入れられます。                  |
| `source`                                                     | string \| オブジェクト    | はい  | プラグインを取得する場所 (相対パス、GitHub、または URL)。                                                                             |
| `description`                                                | 文字列                 | いいえ | プラグインの説明。 最大 1024 文字。                                                                                           |
| `version`                                                    | 文字列                 | いいえ | プラグインのバージョン。                                                                                                    |
| `author`                                                     | オブジェクト              | いいえ | `{ name, email?, url? }`                                                                                        |
| `homepage`                                                   | 文字列                 | いいえ | プラグインのホームページ URL。                                                                                               |
| `repository`                                                 | 文字列                 | いいえ | ソース リポジトリの URL。                                                                                                 |
| `license`                                                    | 文字列                 | いいえ | ライセンス識別子。                                                                                                       |
| `keywords`                                                   | string\[]           | いいえ | キーワードを検索します。                                                                                                    |
| `category`                                                   | 文字列                 | いいえ | プラグイン カテゴリ。                                                                                                     |
| `tags`                                                       | string\[]           | いいえ | その他のタグ。                                                                                                         |
| `commands`                                                   | string \| string\[] | いいえ | コマンド ディレクトリへのパス。                                                                                                |
| `agents`                                                     | string \| string\[] | いいえ | エージェント ディレクトリへのパス(複数可)。                                                                                         |
| `skills`                                                     | string \| string\[] | いいえ | スキル ディレクトリへのパス。                                                                                                 |
| `hooks`                                                      | string \| オブジェクト    | いいえ | hooks の設定またはインラインフック オブジェクトへのパス。                                                                                |
| `mcpServers`                                                 | string \| オブジェクト    | いいえ | プラグインのインストール時にアクティブ化する MCP サーバー。 インライン サーバー マップまたは JSON 構成ファイルへのパスを受け入れます。 プラグイン ソースが独自の MCP 構成を出荷しない場合に使用されます。 |
| `lspServers`                                                 | string \| オブジェクト    | いいえ | LSP 構成またはインライン サーバー定義へのパス。                                                                                      |
| `strict`                                                     | ブーリアン               | いいえ |                                                                                                                 |
| `true` (既定)、プラグインは完全なスキーマと検証規則に準拠している必要があります。                |                     |     |                                                                                                                 |
| `false`場合は、緩やかな検証が使用されるため、特に直接インストールやレガシ プラグインの場合は柔軟性が向上します。 |                     |     |                                                                                                                 |

#### プラグインソースの種類

プラグイン エントリの `source` フィールドは、相対パス文字列、または GitHub リポジトリまたは Git URL ソースを記述するオブジェクトを受け取ります。

```json
{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "ref": "v1.0.0",
        "path": "plugins/my-plugin"
    }
}
```

`github` と `url` の両方のソースタイプでは、`sha` に加えて、またはその代わりに、インストールを特定のコミットに固定するためのオプションの `ref` フィールドを指定できます。

```json
{
    "source": {
        "source": "github",
        "repo": "owner/repo",
        "sha": "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
        "path": "plugins/my-plugin"
    }
}
```

`sha` は、完全な 40 文字のコミット SHA である必要があります。 再現可能なインストールのために`sha`にピン留めし、強制プッシュやタグ/ブランチの付け替えの影響を受けないようにします。

## ファイルの場所

| 品目                                                                                                                                                                              | Path                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| インストールされているプラグイン                                                                                                                                                                |                                                                                                                    |
| `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (Marketplace 経由でインストール)、 `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (直接インストール)                                    |                                                                                                                    |
| Marketplace キャッシュ                                                                                                                                                               | プラットフォーム キャッシュ ディレクトリ: `~/.cache/copilot/marketplaces/` (Linux)、 `~/Library/Caches/copilot/marketplaces/` (macOS)。 |
| `COPILOT_CACHE_HOME`でオーバーライドできます。                                                                                                                                               |                                                                                                                    |
| プラグイン マニフェスト                                                                                                                                                                    |                                                                                                                    |
| `.plugin/plugin.json`、 `plugin.json`、 `.github/plugin/plugin.json`、または `.claude-plugin/plugin.json` (この順序でオン)                                                                   |                                                                                                                    |
| Marketplace マニフェスト                                                                                                                                                              |                                                                                                                    |
| `marketplace.json`、 `.plugin/marketplace.json`、 `.github/plugin/marketplace.json`、または `.claude-plugin/marketplace.json` (この順序でオン)                                               |                                                                                                                    |
| エージェント                                                                                                                                                                          |                                                                                                                    |
| `agents/` (既定、マニフェストでオーバーライド可能)                                                                                                                                                 |                                                                                                                    |
| スキル                                                                                                                                                                             |                                                                                                                    |
| `skills/` (既定、マニフェストでオーバーライド可能)                                                                                                                                                 |                                                                                                                    |
| フックの構成                                                                                                                                                                          |                                                                                                                    |
| `hooks.json` または `hooks/hooks.json`                                                                                                                                             |                                                                                                                    |
| MCP の構成                                                                                                                                                                         |                                                                                                                    |
| `.mcp.json`、`.github/mcp.json`                                                                                                                                                  |                                                                                                                    |
| LSP 構成                                                                                                                                                                          |                                                                                                                    |
| `lsp.json` または `.github/lsp.json`                                                                                                                                               |                                                                                                                    |
| プラグイン データ                                                                                                                                                                       |                                                                                                                    |
| `${COPILOT_PLUGIN_DATA}` ( `${CLAUDE_PLUGIN_DATA}`としても使用できます)。 インストールされている各プラグインに固有の永続的で書き込み可能なディレクトリを指します。 これは、installed-plugins キャッシュ ディレクトリ内のパスではなく、プラグイン固有のランタイム データに使用します。 |                                                                                                                    |

## 読み込みの順序と優先順位

複数のプラグインをインストールすると、一部のカスタム エージェント、スキル、MCP サーバー、または MCP サーバー経由で提供されるツールの名前が重複している可能性があります。 この状況では、優先順位に基づいて、使用するコンポーネントが CLI によって決定されます。

* **エージェントとスキル**では、最初に見つかったものが優先されます。

  インストールするプラグインと同じ名前または ID を持つプロジェクト レベルのカスタム エージェントまたはスキルがある場合、プラグインのエージェントまたはスキルは自動的に無視されます。 プラグインは、プロジェクト レベルまたは個人用の構成をオーバーライドできません。 カスタム エージェントは、ファイル名から派生した ID を使用して重複除去されます (たとえば、ファイル名が `reviewer.agent.md`、エージェント ID は `reviewer`)。 スキルは、 `SKILL.md` ファイル内の名前フィールドによって重複除去されます。

* **MCP サーバー** では、最終優先優先順位が使用されます。

  既にインストールした MCP サーバーと同じサーバー名を持つ MCP サーバーを定義するプラグインをインストールすると、プラグインの定義が優先されます。
  `--additional-mcp-config` コマンドライン オプションを使用すると、プラグインを使用してインストールされた同じ名前の MCP サーバー構成をオーバーライドできます。 2 つ以上のプラグインで同じ名前の MCP サーバーが宣言されている場合、CLI は最後に読み込まれたプラグインのバージョンを使用し、それを定義した以前のプラグインごとに警告の名前付けが表示されます。

* **組み込みのツールとエージェント** は常に存在し、ユーザー定義コンポーネントによってオーバーライドすることはできません。

次の図は、読み込みの順序と優先順位の規則を示しています。

```text
┌──────────────────────────────────────────────────────────────────┐
│  BUILT-IN - HARDCODED, ALWAYS PRESENT                            │
│  • tools: bash, view, apply_patch, glob, rg, task, ...           │
│  • agents: explore, task, code-review, general-purpose, research │
└────────────────────────┬─────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID)                 │
  │  1. ~/.copilot/agents/           (user, .github convention)         │
  │  2. <project>/.github/agents/    (project)                          │
  │  3. <parents>/.github/agents/    (inherited, monorepo)              │
  │  4. <project>/.claude/agents/    (project)                          │
  │  5. <parents>/.claude/agents/    (inherited, monorepo)              │
  │  6. PLUGIN: agents/ dirs         (plugin, by install order)         │
  │  7. Remote org/enterprise agents (remote, via API)                  │
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  AGENT SKILLS - FIRST LOADED IS USED (dedup by name)                │
  │  1. <project>/.github/skills/        (project)                      │
  │  2. <project>/.agents/skills/        (project)                      │
  │  3. <project>/.claude/skills/        (project)                      │
  │  4. <parents>/.github/skills/ etc.   (inherited)                    │
  │  5. ~/.copilot/skills/               (personal-copilot)             │
  │  6. ~/.agents/skills/                (personal-agents)              │
  │  7. PLUGIN: skills/ dirs             (plugin)                       │
  │  8. COPILOT_SKILLS_DIRS env + config (custom)                       │
  │  --- then commands (.claude/commands/), skills override commands ---│
  └──────────────────────┬──────────────────────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────────────────────┐
  │  MCP SERVERS - LAST LOADED IS USED (dedup by server name)           │
  │  1. ~/.copilot/mcp-config.json       (lowest priority)              │
  │  2. PLUGIN: MCP configs              (plugins)                      │
  │  3. --additional-mcp-config flag     (highest priority)             │
  └─────────────────────────────────────────────────────────────────────┘
```

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

* [エンタープライズで管理されるプラグインの標準について](/ja/enterprise-cloud@latest/copilot/concepts/agents/about-enterprise-plugin-standards)
* [GitHub Copilot CLI](/ja/enterprise-cloud@latest/copilot/how-tos/copilot-cli)
* [GITHUB COPILOT CLI コマンド リファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference)
* [GitHub Copilot CLI プログラムリファレンス](/ja/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference)