plugin-forge

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 "[email protected]" \
  --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": "[email protected]"
  },
  "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/	フロントマター付きの Markdown
Skills	skills/<name>/	SKILL.md を含むディレクトリ
Agents	agents/	Markdown による定義
Hooks	hooks/hooks.json	イベントハンドラー
MCP Servers	.mcp.json	外部連携

5. ローカルテスト

# Add marketplace
/plugin marketplace add /path/to/marketplace-root

# Install plugin
/plugin install plugin-name@marketplace-name

# After changes: reinstall
/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

バージョン管理

重要: バージョンは次の2か所の両方で更新してください:

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	バージョンを更新