GitHub Copilot CLI（コマンドラインインターフェース）のプラグインの作成

イントロダクション

プラグインは、Copilot CLI の機能を拡張するパッケージです。「GitHub Copilot CLI（コマンドラインインターフェース）のプラグインについて」を参照してください。

メモ

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

プラグインの構造

プラグインは、特定の構造を持つディレクトリで構成されます。少なくとも、ディレクトリのルートに plugin.json マニフェストファイルが含まれている必要があります。エージェント、スキル、フック、および MCP サーバー構成の任意の組み合わせを含めることもできます。

プラグイン構造の例

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)

プラグインの作成

プラグインのディレクトリを作成します。

       `plugin.json`マニフェスト ファイルをディレクトリのルートに追加します。


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

JSON

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

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

このファイルに含めることができるフィールドの完全なセットの詳細については、 GitHub Copilot CLI プラグインリファレンスを参照してください。

エージェント、スキル、フック、および MCP サーバー構成に適したファイルとディレクトリを作成して、いくつかのコンポーネントをプラグインに追加します。

例えば次が挙げられます。
1. ```
    `NAME.agent.md` サブディレクトリに`agents` ファイルを作成して、エージェントを追加します。
```
  Markdown
```
---
name: my-agent
description: Helps with specific tasks
tools: ["bash", "edit", "view"]
---

You are a specialized assistant that...
```
```
---
name: my-agent
description: Helps with specific tasks
tools: ["bash", "edit", "view"]
---

You are a specialized assistant that...
```
2. プラグインディレクトリの skills/NAME サブディレクトリを作成してスキルを追加します。ここで、 NAME はスキルの名前です。次に、このサブディレクトリ内に、スキルを定義する SKILL.md ファイルを作成します。
  
  たとえば、"デプロイ" スキルを作成するには、 skills/deploy/SKILL.mdを作成します。
  Markdown
```
---
name: deploy
description: Deploy the current project to...
---

Instructions for the skill...
```
```
---
name: deploy
description: Deploy the current project to...
---

Instructions for the skill...
```
プラグインをローカルにインストールして、開発時にテストできるようにします。

たとえば、 ./my-plugin がプラグインディレクトリへのパスである場合は、次のように入力します。
Shell
```
copilot plugin install ./my-plugin
```
```
copilot plugin install ./my-plugin
```
インストールされているプラグインの一覧を表示して、プラグインが正常に読み込まれたことを確認します。
Shell
```
copilot plugin list
```
```
copilot plugin list
```
または、新しい対話型セッションを開始し、次のように入力できます。
Copilot prompt
```
/plugin list
```
```
/plugin list
```
定義したエージェント、スキル、フック、および MCP サーバー構成が正しく読み込まれたことを確認します。

たとえば、対話型セッションで、プラグインで定義されているカスタムエージェントが読み込まれたことを確認するには、次のように入力します。
Copilot prompt
```
/agent
```
```
/agent
```
プラグインで定義されているスキルが読み込まれたことを確認するには、次のように入力します。
Copilot prompt
```
/skills list
```
```
/skills list
```
プラグインのコンポーネントによって提供される機能を使用して、各コンポーネントが期待どおりに動作することを確認します。
必要に応じて、プラグインの開発を繰り返します。
重要

プラグインをインストールすると、そのコンポーネントがキャッシュされ、CLI は後続のセッションのためにキャッシュから読み取ります。ローカルプラグインに加えられた変更を取得するには、もう一度インストールします。
Shell
```
copilot plugin install ./my-plugin
```
```
copilot plugin install ./my-plugin
```
テストが完了したら、次のように入力してプラグインのローカルバージョンをアンインストールできます。
Shell
```
copilot plugin uninstall NAME
```
```
copilot plugin uninstall NAME
```
メモ

プラグインをアンインストールするには、プラグインのディレクトリへのパスではなく、プラグインのname マニフェストファイルのplugin.json フィールドで指定されているプラグインの名前を使用します。

プラグインの配布

プラグインを配布するには、それをマーケットプレースに追加します。「GitHub Copilot CLI（コマンドラインインターフェース）のプラグインマーケットプレースの作成」を参照してください。

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

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)

        [AUTOTITLE](/copilot/reference/cli-plugin-reference)

GitHub Copilot CLI（コマンドラインインターフェース） のプラグインの作成

この記事の内容