create-plugin

プラグインの作成

Claude Code プラグインをゼロからスキャフォールドします。

使用するタイミング

スキル、コマンド、エージェントを追加して Claude Code を拡張する新しいプラグインを作成するときに使用します。正しいディレクトリ構造を生成し、MCP ツールを接続します。

手順

1. ユーザーからプラグイン名と説明を聞きます
2. 競合を確認します — mcp__plugin_ruflo-core_ruflo__transfer_plugin-search を呼び出し、その名前が使用されていないことを確認します
3. ディレクトリ構造を作成します（兄弟プラグインの ADR-0001 に記載された標準プラグインコントラクトに準拠します）。

   plugins/<name>/
   ├── .claude-plugin/
   │   └── plugin.json
   ├── skills/
   │   └── <skill-name>/
   │       └── SKILL.md
   ├── commands/
   │   └── <command-name>.md
   ├── agents/
   │   └── <agent-name>.md
   ├── docs/
   │   └── adrs/
   │       └── 0001-<name>-contract.md     # Plugin-level ADR (Proposed)
   ├── scripts/
   │   └── smoke.sh                         # Structural contract (≥8 checks)
   └── README.md                            # Compatibility + Namespace coordination + Verification + ADR sections
   

4. 名前、説明、バージョン、作成者を含む plugin.json を生成します（skills、commands、agents の配列は含めないでください。Claude Code がディレクトリ構造から自動検出します）
5. 適切なフロントマターを含む SKILL.md ファイルを生成します。

   ---
   name: skill-name
   description: What this skill does
   allowed-tools: mcp__plugin_ruflo-core_ruflo__tool1 mcp__plugin_ruflo-core_ruflo__tool2 Bash
   ---
   

6. 名前と説明のフロントマターを含むコマンドファイルを生成します
7. 名前、説明、model: sonnet を含むエージェントファイルを生成します
8. インストール手順、機能、コマンド、スキル、および標準プラグインコントラクトのセクションを含む README.md を生成します。
   • 互換性 — @claude-flow/cli の v3.6 以降のメジャー・マイナーバージョンに固定します
   • 名前空間の調整 — kebab-case の <plugin-stem>-<intent> 名前空間を確保します。ruflo-agentdb ADR-0001 §「名前空間の規約」に従います
   • 検証 — bash plugins/<name>/scripts/smoke.sh
   • アーキテクチャ決定 — ADR-0001 へのリンク
9. docs/adrs/0001-<name>-contract.md に ADR-0001（提案中）を生成し、固定、名前空間の調整、該当する場合は MCP ツールの表面数、スモークテストの契約範囲を記録します。ステータスは Proposed にします。
10. scripts/smoke.sh を生成します — 最低 8 つの構造チェックを実施します。バージョンとキーワード、妥当なフロントマターを含むスキル／エージェント／コマンドの有無、README の v3.6 固定、README の名前空間調整ブロック、Proposed ステータスの ADR の有無、スキル内にワイルドカードツールがないことを確認します。
11. Ruflo マーケットプレイスに追加する場合は、marketplace.json を更新します。

回避すべき MCP ツールの不整合（兄弟 ADR から得られた教訓）

いくつかのプラグインでは、ループが検出してきた微妙な MCP の不具合が発生しています。同じ問題を繰り返さないでください。

• embeddings_embed は存在しません。 実際のツールは embeddings_generate です。allowed-tools の行で embeddings_embed を参照しないでください。
• agentdb_hierarchical-* は名前空間でルーティングされません。 tier（working|episodic|semantic）でルーティングされます。namespace ではなく tier を渡してください。名前空間を指定した読み書きには、代わりに memory_* を使用してください。
• agentdb_pattern-* は名前空間でルーティングされません。 ReasoningBank 経由でルーティングされます。namespace 引数を渡さないでください。フォールバック時には memory-store-fallback 経由で予約済みの pattern 名前空間に書き込まれます。
• 単数形の pattern と複数形の patterns は異なる名前空間です。 ReasoningBank のフォールバックは pattern に書き込み、hooks_pretrain は patterns に書き込みます。混同しないでください。

Plugin.json スキーマ

必須フィールド：

• name — プラグイン識別子（kebab-case）
• description — プラグインの機能
• version — semver

推奨フィールド：

• author — { "name": "...", "url": "..." }
• homepage、license、keywords

任意フィールド：

• graph_adapter — ADR-130 のグラフインテリジェンスコントラクト（生成される出力ではデフォルトでコメントアウトされています）。

  // "graph_adapter": {
  //   "edgeRelations": ["my-relation-type"],
  //   "nodeTypes": ["entity"],
  //   "autoRegister": true
  // }
  

  autoRegister: true の場合、プラグインのエッジはコアグラフレイヤーによって graph_edges の書き込みに自動的に含められます。このプラグインが生成するリレーションタイプである edgeRelations を宣言してください。

plugin.json に skills、commands、agents の配列を含めないでください。 これらは Claude Code がディレクトリ構造から自動検出するため、含めると検証エラーになります。

接続可能な MCP ツール

利用可能なツールを確認する：mcp__plugin_ruflo-core_ruflo__transfer_plugin-info

一般的なツールカテゴリ：

• memory_* — 保存、検索、取得
• agentdb_* — 15 個のコントローラーブリッジツール（namespace 引数は渡さないでください。tier または ReasoningBank によってルーティングされます）。実行時に agentdb_controllers を呼び出して、正式な一覧を確認してください
• neural_* — ニューラルトレーニングと予測
• hooks_* — ライフサイクルフックとインテリジェンス
• browser_* — ブラウザー自動化
• workflow_* — ワークフロー管理
• aidefence_* — 安全性スキャン
• embeddings_* — 10 個のベクトル埋め込みツール（embeddings_embed は存在しないため、embeddings_generate を使用してください）