CC Plugin Forge

目的

正しい構造、マニフェスト、マーケットプレイス統合を備えた Claude Code プラグインを構築・管理します。ワークフロー、自動化スクリプト、リファレンスドキュメントを含みます。

使用する時期

• マーケットプレイス用の新しいプラグインを作成する場合
• プラグインコンポーネント (コマンド、スキル、エージェント、フック) を追加・修正する場合
• プラグインのバージョンを更新する場合
• プラグインまたはマーケットプレイスのマニフェストを操作する場合
• ローカルプラグインテストをセットアップする場合
• プラグインを公開する場合

はじめ方

新しいプラグインを作成

create_plugin.py を使用してプラグイン構造を生成します：

python scripts/create_plugin.py plugin-name \
  --marketplace-root /path/to/marketplace \
  --author-name "Your Name" \
  --author-email "your.email@example.com" \
  --description "Plugin description" \
  --keywords "keyword1,keyword2" \
  --category "productivity"

自動的に以下が行われます：

• プラグインディレクトリ構造を作成
• plugin.json マニフェストを生成
• README テンプレートを作成
• marketplace.json を更新

バージョンをアップデート

bump_version.py を使用して両方のマニフェストのバージョンを更新します：

python scripts/bump_version.py plugin-name major|minor|patch \
  --marketplace-root /path/to/marketplace

セマンティックバージョニング：

• major: 破壊的変更 (1.0.0 → 2.0.0)
• minor: 新機能、リファクタリング (1.0.0 → 1.1.0)
• patch: バグ修正、ドキュメント (1.0.0 → 1.0.1)

開発ワークフロー

1. 構造を作成

手動アプローチ (スクリプトを使用しない場合)：

mkdir -p plugins/plugin-name/.claude-plugin
mkdir -p plugins/plugin-name/commands
mkdir -p plugins/plugin-name/skills

2. プラグインマニフェスト

ファイル: plugins/plugin-name/.claude-plugin/plugin.json

{
  "name": "plugin-name",
  "version": "0.1.0",
  "description": "Plugin description",
  "author": {
    "name": "Your Name",
    "email": "your.email@example.com"
  },
  "keywords": ["keyword1", "keyword2"]
}

3. マーケットプレイスに登録

.claude-plugin/marketplace.json を更新します：

{
  "name": "plugin-name",
  "source": "./plugins/plugin-name",
  "description": "Plugin description",
  "version": "0.1.0",
  "keywords": ["keyword1", "keyword2"],
  "category": "productivity"
}

4. コンポーネントを追加

各ディレクトリに作成します：

コンポーネント	場所	フォーマット
Commands	commands/	frontmatter付きMarkdown
Skills	skills/<name>/	SKILL.md を含むディレクトリ
Agents	agents/	Markdown定義
Hooks	hooks/hooks.json	イベントハンドラー
MCP Servers	.mcp.json	外部統合

5. ローカルテスト

# マーケットプレイスを追加
/plugin marketplace add /path/to/marketplace-root

# プラグインをインストール
/plugin install plugin-name@marketplace-name

# 変更後: 再インストール
/plugin uninstall plugin-name@marketplace-name
/plugin install plugin-name@marketplace-name

プラグインパターン

フレームワークプラグイン

フレームワーク固有のガイダンス (React、Vue など) の場合：

plugins/framework-name/
├── .claude-plugin/plugin.json
├── skills/
│   └── framework-name/
│       ├── SKILL.md
│       └── references/
├── commands/
│   └── prime/
│       ├── components.md
│       └── framework.md
└── README.md

ユーティリティプラグイン

ツールとコマンド用：

plugins/utility-name/
├── .claude-plugin/plugin.json
├── commands/
│   ├── action1.md
│   └── action2.md
└── README.md

ドメインプラグイン

ドメイン固有の知識用：

plugins/domain-name/
├── .claude-plugin/plugin.json
├── skills/
│   └── domain-name/
│       ├── SKILL.md
│       ├── references/
│       └── scripts/
└── README.md

コマンド命名

サブディレクトリベースのネームスペース (: セパレータ使用)：

• commands/namespace/command.md → /namespace:command
• commands/simple.md → /simple

例：

• commands/prime/vue.md → /prime:vue
• commands/docs/generate.md → /docs:generate

バージョン管理

重要： 両方の場所でバージョンを更新してください：

1. plugins/<name>/.claude-plugin/plugin.json
2. .claude-plugin/marketplace.json

bump_version.py を使用して自動化します。

Git コミット

Conventional Commits を使用します：

git commit -m "feat: add new plugin"
git commit -m "fix: correct plugin manifest"
git commit -m "docs: update plugin README"
git commit -m "feat!: breaking change"

リファレンスドキュメント

詳細なドキュメントが含まれています：

リファレンス	内容
references/plugin-structure.md	ディレクトリ構造、マニフェストスキーマ、コンポーネント
references/marketplace-schema.md	マーケットプレイス形式、プラグインエントリ、配布
references/workflows.md	ステップバイステップワークフロー、パターン、公開

スクリプト

スクリプト	目的
scripts/create_plugin.py	新しいプラグインをスキャフォールド
scripts/bump_version.py	バージョンを更新