Team Builder
対話型メニューを使用して、オンデマンドでエージェントチームを閲覧・構成します。フラット構成またはドメインサブディレクトリ構成のエージェントコレクションに対応しています。
使用するタイミング
- 複数のエージェントペルソナ（マークダウンファイル）があり、タスクに使用するものを選択したい場合
- 異なるドメイン（例：セキュリティ + SEO + アーキテクチャ）からアドホックなチームを構成したい場合
- 決定する前に、どのエージェントが利用可能かを確認したい場合
前提条件
エージェントファイルは、ペルソナプロンプト（アイデンティティ、ルール、ワークフロー、成果物）を含むマークダウンファイルである必要があります。最初の # 見出し がエージェント名として使用され、最初の段落が説明として使用されます。
フラット構成とサブディレクトリ構成の両方をサポートします。
サブディレクトリ構成 — ドメインはフォルダ名から推測されます。
agents/
├── engineering/
│ ├── security-engineer.md
│ └── software-architect.md
├── marketing/
│ └── seo-specialist.md
└── sales/
└── discovery-coach.md
フラット構成 — ドメインは共有ファイル名プレフィックスから推測されます。2つ以上のファイルがプレフィックスを共有する場合、そのプレフィックスがドメインとしてカウントされます。一意のプレフィックスを持つファイルは「General」に分類されます。注：アルゴリズムは最初の - で分割するため、複数単語のドメイン（例：product-management）は代わりにサブディレクトリ構成を使用してください。
agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md
設定
エージェントは2つの方法で発見され、エージェント名でマージおよび重複排除されます。
claude agentsコマンド（プライマリ）—claude agentsを実行して、CLIが認識しているすべてのエージェント（ユーザーエージェント、プラグインエージェント（例：ecc:architect）、ビルトインエージェントを含む）を取得します。これにより、パス設定なしでECCマーケットプレイスのインストールが自動的にカバーされます。- ファイルグロブ（フォールバック、エージェントコンテンツ読み取り用）— エージェントのマークダウンファイルは以下から読み取られます。
./agents/**/*.md+./agents/*.md— プロジェクトローカルエージェント~/.claude/agents/**/*.md+~/.claude/agents/*.md— グローバルユーザーエージェント
名前が衝突した場合、以前のソースが優先されます：ユーザーエージェント > プラグインエージェント > ビルトインエージェント。ユーザーが指定した場合、代わりにカスタムパスを使用できます。
仕組み
ステップ1：利用可能なエージェントを発見する
claude agents を実行して、完全なエージェントリストを取得します。各行を解析します。
- プラグインエージェント は
プラグイン名:というプレフィックスが付きます（例：ecc:security-reviewer）。:以降をエージェント名、プラグイン名をドメインとして使用します。 - ユーザーエージェント はプレフィックスがありません。
~/.claude/agents/または./agents/から対応するマークダウンファイルを読み取り、名前と説明を抽出します。 - ビルトインエージェント（例：
Explore、Plan）は、ユーザーが明示的に含めるように要求しない限りスキップされます。
マークダウンファイルからロードされたユーザーエージェントの場合：
- サブディレクトリ構成： 親フォルダ名からドメインを抽出します
- フラット構成： すべてのファイル名プレフィックス（最初の
-の前のテキスト）を収集します。プレフィックスは、2つ以上のファイル名に出現する場合にのみドメインとして適格となります（例：engineering-security-engineer.mdとengineering-software-architect.mdは両方ともengineeringで始まる → Engineeringドメイン）。一意のプレフィックスを持つファイル（例：code-reviewer.md、tdd-guide.md）は「General」の下にグループ化されます - 最初の
# 見出しからエージェント名を抽出します。見出しがない場合は、ファイル名から名前を派生させます（.mdを削除し、ハイフンをスペースに置き換え、タイトルケースにする） - 見出しの後の最初の段落から1行の要約を抽出します
claude agents の実行とファイル場所の調査後、エージェントが見つからない場合は、ユーザーに「No agents found. Run claude agents to verify your setup.」と通知します。その後、停止します。
ステップ2：ドメインメニューを表示する
利用可能なエージェントドメイン：
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist
ドメインを選択するか、特定のエージェントを指定してください（例：「1,3」または「security + seo」）：
- エージェントがゼロのドメイン（空のディレクトリ）はスキップします
- ドメインごとのエージェント数を表示します
ステップ3：選択を処理する
柔軟な入力を受け付けます：
- 数字：「1,3」はEngineeringとSalesのすべてのエージェントを選択
- 名前：「security + seo」は発見されたエージェントに対してあいまい一致
- 「all from engineering」はそのドメインのすべてのエージェントを選択
5体を超えるエージェントが選択された場合は、アルファベット順にリストし、ユーザーに絞り込むよう依頼します：「You selected N agents (max 5). Pick which to keep, or say 'first 5' to use the first five alphabetically.」
選択を確認します：
選択中：Security Engineer + SEO Specialist
何に取り組むべきですか？（タスクを説明してください）：
ステップ4：エージェントを並列に起動する
- 選択された各エージェントのマークダウンファイルを読み取ります
- まだ提供されていない場合は、タスクの説明を求めます
- Agentツールを使用してすべてのエージェントを並列に起動します：
subagent_type: "general-purpose"prompt: "{エージェントファイルの内容}\n\nタスク: {タスクの説明}"- 各エージェントは独立して実行されます—エージェント間の通信は不要です
- エージェントが失敗した場合（エラー、タイムアウト、または空の出力）、インラインで失敗を記録し（例：「Security Engineer: failed — [理由]」）、成功したエージェントの結果を続行します
ステップ5：結果を統合する
すべての出力を収集し、統合レポートを提示します：
- エージェントごとにグループ化された結果
- 統合セクションで以下を強調表示：
- エージェント間の一致点
- 推奨事項間の競合や緊張関係
- 推奨される次のステップ
1体のみのエージェントが選択された場合は、統合をスキップし、出力を直接提示します。
ルール
- 動的な発見のみ。 エージェントリストをハードコードしないでください。ディレクトリ内の新しいファイルは自動的にメニューに表示されます。
- チームあたり最大5体のエージェント。 5体を超えると、効果が減少し、トークン使用量が過剰になります。選択時に強制します。
- 並列ディスパッチ。 すべてのエージェントが同時に実行されます—Agentツールの並列呼び出しパターンを使用します。
- 並列Agent呼び出しであり、TeamCreateではない。 このスキルは、独立した作業のための並列Agentツール呼び出しを使用します。TeamCreate（マルチエージェント対話のためのClaude Codeツール）は、エージェントが互いに議論したり応答したりする必要がある場合にのみ必要です。
例
ユーザー：team builder
Claude：
利用可能なエージェントドメイン：
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer
4. Support (1) — Executive Summary
ドメインを選択するか、特定のエージェントを指定してください：
ユーザー：security + seo
Claude：
選択中：Security Engineer + SEO Specialist
何に取り組むべきですか？
ユーザー：起動前にNext.jsのeコマースサイトをレビューして
[両方のエージェントが並列に起動し、それぞれがコードベースに専門知識を適用]
Claude：
## Security Engineerの発見事項
- [発見事項...]
## SEO Specialistの発見事項
- [発見事項...]
## 統合
両エージェントが一致した点：[...]
緊張関係：SecurityはインラインスタイルをブロックするCSPを推奨、SEOはインラインスキーママークアップを必要としています。解決策：[...]
次のステップ：[...]