plugin-creator

プラグイン作成ツール

新しい cave プラグインのひな形を作成します。cave プラグインは、.cave-plugin/plugin.json マニフェストと、コマンド、スキル、エージェント、テーマ、フック用の任意のサブディレクトリを含む、GitHub（または任意の zip URL）で公開されるディレクトリです。

マニフェストのスキーマ

{
  "name": "my-plugin",
  "version": "0.1.0",
  "description": "A short, clear description of what this plugin does.",
  "author": "your-github-handle",
  "license": "MIT",
  "homepage": "https://github.com/your-handle/my-plugin",
  "caveVersion": ">=0.65.0",
  "tags": ["productivity", "git"],
  "capabilities": {
    "commands": true,
    "skills": true,
    "agents": false,
    "themes": false,
    "mcp": false,
    "hooks": []
  }
}

フィールドのルール

• name：kebab-case を使用し、a-z0-9 とハイフンのみを指定します。マーケットプレイス内で一意である必要があります。
• version：semver（「major.minor.patch」）を指定します。
• description：プレーンテキストで一文の説明を指定します。
• tags：caveman plugin search の検索に使用する任意の文字列を指定します。
• capabilities.commands：commands/ ディレクトリがある場合は true に設定します。
• capabilities.skills：skills/ ディレクトリがある場合は true に設定します。
• capabilities.agents：agents/ ディレクトリがある場合は true に設定します。
• capabilities.themes：themes/ ディレクトリがある場合は true に設定します。
• capabilities.mcp：.mcp.json がある場合は true に設定します。
• capabilities.hooks：フックエントリーの配列です（以下を参照）。

フックエントリーの形式

{ "event": "PostToolUse", "command": "hooks/post-tool-use.sh", "matcher": "Bash" }

ディレクトリ構成

my-plugin/
├── .cave-plugin/
│   └── plugin.json          ← required
├── commands/
│   └── my-command.md        ← markdown slash commands
├── skills/
│   └── my-skill/
│       └── SKILL.md         ← skill with frontmatter
├── agents/
│   └── my-agent.md          ← agent definition markdown
├── themes/
│   └── my-theme.json        ← theme JSON (cave theme format)
├── hooks/
│   └── post-tool-use.sh     ← hook scripts (chmod +x)
├── .mcp.json                ← optional MCP server definitions
└── README.md

ひな形の作成手順

ユーザーからプラグインの作成を依頼された場合は、以下の手順に従います。

1. プラグインの詳細を確認します（名前、説明、必要な機能）。
2. 上記のスキーマを使用して .cave-plugin/plugin.json を作成します。
3. 必要なサブディレクトリのみを作成します（空のディレクトリは作成しません）。
4. 有効にした各機能の プレースホルダーファイルを追加します。
   • commands/example.md にフロントマター ---\ndescription: Example command.\n---\n\n# Example\n\nDescribe what this command does.\n を記述します。
   • skills/example/SKILL.md に標準のスキル用フロントマターを記述します。
   • agents/example.md にエージェント用フロントマターを記述します。
   • hooks/example.sh に #!/bin/bash\n# Hook: <event>\n を記述し、chmod +x を実行します。
5. インストール手順と簡潔な説明を含む README.md を作成します。
6. 必須フィールドがすべて揃っていることを確認し、マニフェストを出力して 検証します。

公開

ひな形の作成後、ユーザーに以下の手順を案内します。

1. プラグインを公開 GitHub リポジトリにプッシュします。
2. marketplace.json にエントリーを追加して、マーケットプレイスに登録します。

   {
     "plugins": [
       {
         "ref": "your-handle/my-plugin",
         "name": "my-plugin",
         "description": "...",
         "tags": ["..."],
         "version": "0.1.0"
       }
     ]
   }
   

3. ユーザーは次のコマンドでインストールします：caveman plugin install your-handle/my-plugin

やり取りの例

ユーザー：「/summarize コマンドと post-save フックを追加するプラグインを作成して。」

あなた：

1. "commands": true, "hooks": [{ "event": "PostToolUse", "command": "hooks/post-save.sh", "matcher": "Write" }] を含む .cave-plugin/plugin.json を作成します。
2. 要約用スラッシュコマンドの説明を含む commands/summarize.md を作成します。
3. スタブのフックスクリプトとして hooks/post-save.sh を作成します。
4. README.md を作成します。
5. 作成したファイルツリーを報告します。