validate-plugin

プラグインの検証

プラグインが正しい Claude Code プラグイン形式に従っているか検証します。

使用するタイミング

プラグインを作成または変更した後、公開前に構造上の問題を検出するため、検証を実行してください。

実行されるチェック

1. ディレクトリ構造 — プラグインのルートに .claude-plugin/plugin.json が存在する
2. plugin.json スキーマ — 必須フィールド（name、description、version）がある
3. スキルの自動検出 — 各 skills/<name>/SKILL.md が有効なスキルである（Claude Code はディレクトリから自動検出します。plugin.json に skills 配列を記載してはいけません）
4. コマンドの自動検出 — 各 commands/<name>.md が有効なコマンドである（自動検出されます。plugin.json に commands 配列は不要です）
5. エージェントの自動検出 — 各 agents/<name>.md が有効なエージェントである（自動検出されます。plugin.json に agents 配列は不要です）
6. plugin.json にレガシー配列がない — plugin.json に skills、commands、または agents 配列があると、検証エラーになります（Claude Code がプラグインを拒否する原因になります）
7. SKILL.md のフロントマター — 各スキルに name、description、allowed-tools がある（ワイルドカードは使用しない）
8. エージェントのフロントマター — 各エージェントに name、description、model がある
9. ファイルの配置場所が正しい — スキル、コマンド、エージェントが .claude-plugin/ 内に置かれていない
10. MCP ツールの参照 — allowed-tools 内のツールが有効な mcp__plugin_ruflo-core_ruflo__* 識別子である

手順

1. プラグインの plugin.json を読み込み、skills／commands／agents 配列が存在しないことを確認します
2. skills/*/SKILL.md、commands/*.md、agents/*.md を glob で検索し、それぞれのフロントマターを検証します
3. 各 SKILL.md について、フロントマターに必須フィールドがあり、allowed-tools にワイルドカードがないことを確認します
4. 各エージェントの .md について、フロントマターに必須フィールドがあることを確認します
5. 各チェックの合格／不合格と、実行可能な修正案を報告します