create

⛔ プラグインの作成 — 停止して読む

思い込みで作業を進めないでください。まずこのファイルを読んでください。

これは、Claude Code マーケットプレイスで新しいプラグインを作成するための、構造化されたワークフローコマンドです。

今すぐ実行する最初の、そして唯一のアクションは、以下の TodoWrite を実行することです。

自己進化するスキル：このスキルは使用するたびに改善されます。指示が誤っている場合、パラメーターが変化した場合、または回避策が必要だった場合は、先送りせずにこのファイルをすぐに修正してください。実際に再現できる問題がある場合にのみ更新してください。

⛔ 最初に必ず実行するアクション：TodoWrite の初期化

最初のアクションとして、以下の TodoWrite 呼び出しを必ず実行してください。

次のことは禁止されています。

• ❌ TodoWrite の前にディレクトリを作成しないでください
• ❌ TodoWrite の前に marketplace.json を読まないでください
• ❌ TodoWrite の前に質問しないでください
• ❌ Step 0 を完了せずに、いずれかのフェーズに進まないでください

Step 0.1：マーケットプレイスのルートを検出する

TodoWrite を実行する前に、マーケットプレイスのディレクトリにいることを確認してください。

/usr/bin/env bash << 'PREFLIGHT_EOF'
# Check for marketplace.json in cwd
if [ -f ".claude-plugin/marketplace.json" ]; then
  echo "✅ Marketplace detected: $(jq -r .name .claude-plugin/marketplace.json)"
else
  echo "❌ Not a marketplace directory. Run from a marketplace root."
  exit 1
fi
PREFLIGHT_EOF

Step 0.2：必須の TodoWrite を実行する

今すぐ、以下のテンプレートを使って TodoWrite を実行してください。

TodoWrite with todos:

- "[Plugin] Phase 0: Detect marketplace root" | in_progress
- "[Plugin] Phase 0: Interactive prompts (name, category, components)" | pending
- "[Plugin] Phase 0: Confirm plugin doesn't exist" | pending
- "[Plugin] Phase 1: Skill → plugin-structure (scaffold)" | pending
- "[Plugin] Phase 1: Create plugin directory + plugin.json" | pending
- "[Plugin] Phase 1: Skill → implement-plan-preflight (ADR)" | pending
- "[Plugin] Phase 2: Skill → skill-architecture (if has-skills)" | pending
- "[Plugin] Phase 2: Skill → hook-development (if has-hooks)" | pending
- "[Plugin] Phase 2: Skill → command-development (if has-commands)" | pending
- "[Plugin] Phase 2: Skill → agent-development (if has-agents)" | pending
- "[Plugin] Phase 2: Agent → skill-reviewer (if skills created)" | pending
- "[Plugin] Phase 3: Add to marketplace.json" | pending
- "[Plugin] Phase 3: Run validate-plugins.mjs" | pending
- "[Plugin] Phase 3: Skill → code-hardcode-audit" | pending
- "[Plugin] Phase 3: Agent → plugin-validator" | pending
- "[Plugin] Phase 4: Git commit (conventional format)" | pending
- "[Plugin] Phase 4: Push to remote" | pending
- "[Plugin] Phase 4: Skill → semantic-release" | pending

TodoWrite の完了後、以下の Phase 0 のセクションに進んでください。

---

クイックリファレンス

呼び出すスキル（最適化された順序）

順序	スキル	フェーズ	目的	呼び出し
1	plugin-structure	1	ディレクトリとマニフェスト	Skill(plugin-dev:plugin-structure)
2	implement-plan-preflight	1	ADR、設計仕様、図	Skill(itp:implement-plan-preflight)
3	skill-architecture	2	スキルを作成（has-skills の場合）	Skill(plugin-dev:skill-architecture)
4	hook-development	2	フックを作成（has-hooks の場合）	Skill(plugin-dev:hook-development)
5	command-development	2	コマンドを作成（has-commands の場合）	Skill(plugin-dev:command-development)
6	agent-development	2	エージェントを作成（has-agents の場合）	Skill(plugin-dev:agent-development)
7	code-hardcode-audit	3	品質監査	Skill(itp:code-hardcode-audit)
8	plugin-validator	3	サイレント失敗の監査	Skill(plugin-dev:plugin-validator)
9	release-full	4	リポジトリのリリースパイプラインを実行	moon run repo:release-full

対象外のスキル（重複するため）

スキル	対象外の理由
plugin-dev:skill-development	代わりに skill-architecture を使用します（網羅性が3倍高い）
plugin-dev:plugin-settings	hook-development に統合されています

起動するエージェント

フェーズ	エージェント	目的	呼び出し
2	skill-reviewer	スキルの品質をレビューする	Task(plugin-dev:skill-reviewer)
3	plugin-validator	最終的な構成を検証する	Task(plugin-dev:plugin-validator)

ファイルの場所

成果物	パス	備考
プラグインディレクトリ	plugins/{name}/	メインのプラグインフォルダー
プラグインマニフェスト	plugins/{name}/plugin.json	必須のマニフェスト
プラグイン README	plugins/{name}/README.md	ドキュメント
マーケットプレイス JSON	.claude-plugin/marketplace.json	プラグインエントリーの追加が必要
ADR	docs/adr/YYYY-MM-DD-{name}.md	preflight スキルによって作成
設計仕様書	docs/design/YYYY-MM-DD-{name}/spec.md	preflight スキルによって作成

---

フェーズ 0：探索と検証

マーケットプレイスのルートを検出し、対話形式のプロンプトを使ってプラグイン名、カテゴリー、コンポーネントを収集し、プラグインがまだ存在しないことを確認します。

詳細な手順：フェーズ 0 のリファレンス

フェーズ 0 のゲート

• マーケットプレイスのルートを検出済み（.claude-plugin/marketplace.json が存在）
• プラグイン名を収集済み（ケバブケース、スペースなし）
• カテゴリーを選択済み
• コンポーネントを選択済み（skills/hooks/commands/agents）
• プラグインディレクトリが存在しない
• marketplace.json にプラグインが存在しない

---

フェーズ 1：プラグインのスキャフォールド

1. Skill(plugin-dev:plugin-structure) を呼び出す -- ディレクトリとマニフェストのパターン
2. ユーザーの選択に基づいてコンポーネントのサブディレクトリを含むプラグインディレクトリを作成する
3. マーケットプレイスのバージョンを使って plugin.json を生成する
4. Skill(itp:implement-plan-preflight) を呼び出す -- ADR、設計仕様書、図を作成

詳細な手順：フェーズ 1 のリファレンス

フェーズ 1 のゲート

• プラグインディレクトリが存在する：plugins/$PLUGIN_NAME/
• マーケットプレイスのバージョンを使って plugin.json を作成済み
• ADR が存在する：docs/adr/$ADR_ID.md
• 設計仕様書が存在する：docs/design/$ADR_ID/spec.md
• ADR に両方の図（変更前／変更後とアーキテクチャ）がある

---

フェーズ 2：コンポーネントの作成（条件付き）

ユーザーが選択したコンポーネントのスキルのみを実行します。

コンポーネント	スキルの呼び出し	次の手順
Skills	Skill(plugin-dev:skill-architecture)	Task(plugin-dev:skill-reviewer) を起動
Hooks	Skill(plugin-dev:hook-development)	--
Commands	Skill(plugin-dev:command-development)	--
Agents	Skill(plugin-dev:agent-development)	--

詳細な手順：フェーズ 2 のリファレンス

フェーズ 2 のゲート

• 選択したすべてのコンポーネントを作成済み
• skills がある場合：skill-reviewer エージェントがレビューを完了
• ファイルが plugin-dev のパターンに従っている

---

フェーズ 3：登録と検証

1. プラグインを marketplace.json に追加する（hooks がある場合は hooks フィールドを含める）
2. node scripts/validate-plugins.mjs を実行する -- すべて合格することを確認
3. Skill(itp:code-hardcode-audit) を呼び出す -- 品質監査
4. すべてのフックのエントリーポイントでサイレント失敗監査を実行する
5. Task(plugin-dev:plugin-validator) を起動する -- 構造検証

詳細な手順：フェーズ 3 のリファレンス

フェーズ 3 のゲート

• プラグインを marketplace.json に追加済み
• validate-plugins.mjs が合格
• code-hardcode-audit が合格
• silent-failure-audit が合格（エラーなし）
• plugin-validator エージェントが承認

---

フェーズ 4：コミットとリリース

1. 変更をステージングする：プラグインディレクトリ、marketplace.json、ADR、設計仕様書
2. Conventional Commit：feat($PLUGIN_NAME): add plugin for [brief description]
3. リモートにプッシュする
4. moon run repo:release-full を実行する -- リポジトリのリリースパイプライン：タグ、変更履歴、GitHub リリース

詳細な手順：フェーズ 4 のリファレンス

フェーズ 4 の成功基準

• すべての変更を通常のコミット形式でコミット済み
• リモートにプッシュ済み
• semantic-release が完了済み
• 新しいバージョンタグを作成済み
• GitHub リリースを公開済み

トラブルシューティング

よくある問題とその解決方法については、トラブルシューティングのリファレンスを参照してください。

実行後の振り返り

このスキルの実行が完了した後、タスクを終了する前に振り返ってください。

0. 自分の場所を確認します。 — 編集前に、このスキルの正規の SKILL.md のパスを特定します（このスキル名で Glob を実行します）。すべての修正対象はこのファイルと同階層の references/ のみです。他のドキュメントは対象にしないでください。
1. 何が失敗しましたか？ — 原因となった指示を修正します。再発する可能性がある場合は、アンチパターンとして追加します。
2. 予想以上にうまくいったことは何ですか？ — 推奨プラクティスとして取り入れます。その理由を記録します。
3. 何が現状とずれていましたか？ — 実態と一致しなくなったスクリプト、リファレンス、外部依存関係があれば、今すぐ修正します。
4. 記録します。 — すべての変更について、きっかけ、修正内容、根拠を進化ログに記録します。

先送りしないでください。次回の実行では、残された状態がそのまま引き継がれます。

---

---