Extension Generator

ユーザーの自然言語指示からClaude Codeの拡張機能を提案・生成するスキル。

ワークフロー

Step 1: 要件ヒアリング

ユーザーの指示から以下を確認（不明な場合は質問）:

目的: 何を解決したいか？
トリガー: いつ使いたいか？（明示的 or 自動検出）
複雑さ: 単純なプロンプト？複数ステップ？外部ツール連携？
独立性: メイン会話で実行？独立コンテキストが必要？
再利用性: 個人用？チーム共有？

Step 2: 構成を提案

要件に基づいて何を作るべきか提案する:

【提案テンプレート】

ご要件を整理すると:
- 目的: ○○
- トリガー: ○○
- 複雑さ: ○○

以下の構成を提案します:

📁 .claude/skills/skill-name/
├── SKILL.md          ← [必須] メイン定義
├── references/       ← [任意] 参照ドキュメント
│   └── xxx.md
└── scripts/          ← [任意] 自動化スクリプト
    └── xxx.py

または

📁 .claude/agents/
└── agent-name.md     ← サブエージェント

理由: ○○

この構成でよろしいですか？

Step 3: 生成実行

承認後、各ファイルを生成。

構成要素ガイド

スキル構造 (.claude/skills/)

skill-name/
├── SKILL.md          # 必須
├── references/       # 任意: 参照ドキュメント
├── scripts/          # 任意: 自動化スクリプト
└── assets/           # 任意: テンプレート等

SKILL.md（必須）

スキルのメイン定義ファイル。

フロントマター（name, description, allowed-tools等）
ワークフロー/手順
使用例

いつ作る: 常に必須

references/（任意）

補足情報・チェックリスト・詳細ガイドを格納。

| 作るべき時 | 例 | |------------|-----| | チェックリストが必要 | SECURITY.md, PERFORMANCE.md | | ドメイン知識が必要 | API_SPEC.md, CODING_STYLE.md | | 複数パターンがある | PATTERNS.md, EXAMPLES.md | | SKILL.mdが長くなりすぎる | 分割して参照 |

参照方法: See [references/xxx.md](references/xxx.md)

scripts/（任意）

自動化スクリプトを格納。

| 作るべき時 | 例 | |------------|-----| | 外部ツール実行が必要 | run-linters.sh | | データ処理が必要 | analyze.py | | ファイル生成が必要 | generate.py | | 検証/バリデーションが必要 | validate.sh |

実行方法: !./scripts/xxx.sh または allowed-tools: Bash(./scripts/*)

サブエージェント (.claude/agents/)

独立コンテキストで動作する特化型AI。

agent-name.md         # 単一ファイル

| 作るべき時 | 理由 | |------------|------| | 独立したコンテキストが必要 | メイン会話を汚さない | | 異なるモデルを使いたい | model: haiku で高速化 | | 複雑なマルチステップタスク | 専門家として動作 | | ツールセットを制限したい | tools: で明示指定 |

複雑さ別の推奨構成

シンプル（単一プロンプト）

skill-name/
└── SKILL.md

例: コミットメッセージ生成、簡単な説明

中程度（チェックリスト・ガイド付き）

skill-name/
├── SKILL.md
└── references/
    ├── CHECKLIST.md
    └── EXAMPLES.md

例: コードレビュー、ドキュメント生成

複雑（外部ツール連携）

skill-name/
├── SKILL.md
├── references/
│   ├── SECURITY.md
│   └── PERFORMANCE.md
└── scripts/
    ├── run-linters.sh
    └── analyze.py

例: 包括的コードレビュー、CI/CD連携

独立実行が必要

.claude/agents/
└── specialist.md

例: デバッガー、データサイエンティスト、探索エージェント

スキル vs サブエージェント選択基準

| 要件 | → | 選択 | |------|---|------| | 知識・ガイドを追加したい | → | スキル | | ワークフローを標準化したい | → | スキル | | メイン会話で実行したい | → | スキル | | 独立コンテキストが必要 | → | サブエージェント | | 異なるモデルを使いたい | → | サブエージェント | | 複雑な探索・調査タスク | → | サブエージェント |

参照ドキュメント

詳細なパターンとテンプレート:

スキル: references/skill-patterns.md
サブエージェント: references/subagent-patterns.md
プロジェクト設定: references/project-config-patterns.md
テンプレート集: references/templates.md

生成スクリプト

スケルトン生成用:

# スキル作成
python scripts/generate_extension.py skill <name> [--simple]

# サブエージェント作成
python scripts/generate_extension.py agent <name> [--scope user|project]

# プロジェクト設定作成
python scripts/generate_extension.py project

See scripts/generate_extension.py