agent-creator

Agent Creator は、完全な Claude Code エキスパートエージェントをスキャフォールドします。frontmatter（name、description、model、tools、skills、hooks）、必須の Agent Workflow セクション、フックスクリプト、マーケットプレイスへの登録を含みます。次の 3 つのフローに対応し、それぞれ最後に `fuse-ai-pilot:sniper` による検証を行います。新しいドメイン／フレームワークのエキスパートを作成する、既存のエージェントを新しいスタック向けに適応させる、エージェントの skills または hooks を更新する、という 3 つです。

エージェントが参照する skills は作成しません。その場合は skill-creator を使用してください。agent-creator は、既存の skills、またはエージェントと一緒に作成する skills を前提に、エージェントの frontmatter とワークフローを設定するだけです。

Agent Creator

Agent Workflow（必須）

エージェントを作成する前に、必ず Agent を介して委任し、2 つのエージェントを並列で起動します（1 つのメッセージ内で Agent を 2 回呼び出します）。生成されるエージェントには tools として Agent と SendMessage が含まれるため、内部でも同じパターンを使用する必要があります。

1. fuse-ai-pilot:explore-codebase - 既存のエージェントを確認し、パターンを分析します
2. fuse-ai-pilot:research-expert - 最新のエージェント規約を取得します

mcp__context7__query-docs はエージェントを起動するのではなく、直接呼び出す MCP です。既存のエージェントの例を取得するため、2 つの Task 呼び出しと並行して直接実行してください。

作成後、検証のために fuse-ai-pilot:sniper を実行します。

---

概要

アクション	使用するタイミング
新規エージェント	新しいドメイン／フレームワークのエキスパートが必要な場合
適応	類似のエージェント（Next.js → React）をコピーする場合
更新	skills の追加や hooks の変更を行う場合

---

重要なルール

1. すべての内容を英語にする - フランス語やその他の言語は使用しないでください
2. frontmatter を完成させる - name、description、model、tools、skills、hooks
3. Agent Workflow セクション - 最初のコンテンツセクションにします
4. SOLID ルールへの参照 - solid-[stack] skill にリンクします
5. marketplace.json に登録する - 登録しないとエージェントは読み込まれません
6. フックスクリプトを実行可能にする - chmod +x
7. Output Format セクションを必須にする - 生成するすべてのエージェントに、標準の ## Output Format セクション（status、files_changed、errors、sources）を定義します。リードから呼び出されたエージェントは、散文ではなく構造化データを返す必要があります

---

アーキテクチャ

plugins/<plugin-name>/
├── agents/
│   └── <agent-name>.md      # Agent definition
├── skills/
│   ├── skill-a/
│   └── solid-[stack]/
├── scripts/
│   └── validate-*.sh        # Hook scripts
└── .claude-plugin/
    └── plugin.json

→ 詳細は architecture.md を参照してください

---

リファレンスガイド

概念

トピック	リファレンス	参照するタイミング
アーキテクチャ	architecture.md	エージェントの構造を理解する場合
Frontmatter	frontmatter.md	YAML 設定を確認する場合
必須セクション	required-sections.md	必須コンテンツを確認する場合
Hooks	hooks.md	ツール実行前／後の検証を行う場合
登録	registration.md	marketplace.json を確認する場合

テンプレート

テンプレート	使用するタイミング
agent-template.md	新しいエージェントを作成する場合
hook-scripts.md	検証スクリプトを作成する場合

---

クイックリファレンス

新しいエージェントを作成する

# 1. Research existing agents
→ explore-codebase + research-expert

# 2. Create files
touch plugins/<plugin>/agents/<agent-name>.md
touch plugins/<plugin>/scripts/validate-<stack>-solid.sh
chmod +x plugins/<plugin>/scripts/*.sh

# 3. Register in marketplace.json

# 4. Validate
→ sniper

既存のエージェントを適応させる

# 1. Copy similar agent
cp plugins/nextjs-expert/agents/nextjs-expert.md plugins/new-plugin/agents/new-expert.md

# 2. Adapt with sed
sed -i '' "s/nextjs/newstack/g; s/Next\.js/NewStack/g" agents/new-expert.md

# 3. Update skills, tools, register

---

検証チェックリスト

• すべての内容が英語である
• Frontmatter が完成している（name、description、model、tools、skills）
• Agent Workflow セクションがある
• 必須の Skills Usage テーブルがある
• solid-[stack] への SOLID ルール参照がある
• Local Documentation のパスが有効である
• Output Format セクションがある（status、files_changed、errors、sources）
• フックスクリプトが実行可能である
• marketplace.json に登録されている

---

関連項目：Skill Creator

エージェントを作成するときは、skills も作成することがよくあります。

エージェント用の skills を作成するには、/fuse-ai-pilot:skill-creator を使用してください。

シナリオ	アクション
新しいエージェントに skills が必要	先に skill-creator で skills を作成します
エージェントが skills を参照する	skills/ に skills があることを確認します
エージェントを適応させる	関連する skills も適応させます

---

ベストプラクティス

DO

• 関連するスキルには skill-creator を使用してください
• SOLID のルールには solid-[stack] スキルを参照してください
• UI エージェントには Gemini Design のセクションを含めてください
• フックスクリプトに実行権限を付与してください

DON'T

• フランス語で書かないでください（英語のみ）
• Agent Workflow セクションを省略しないでください
• マーケットプレイスへの登録を忘れないでください
• スキルなしでエージェントを作成しないでください
• フック内でパスをハードコードしないでください（$CLAUDE_PLUGIN_ROOT を使用してください）