チームビルダー

チームビルダー は何をしますか？

対話型メニューを使って、オンデマンドでエージェントチームをブラウズし、構成します。フラット構造またはドメイン別サブディレクトリ構造のエージェントコレクションに対応しています。

使用タイミング

• 複数のエージェントペルソナ（マークダウンファイル）があり、タスクにどれを使うか選びたい場合
• 異なるドメイン（例：セキュリティ + 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つの方法で発見され、エージェント名でマージ・重複排除されます。

1. claude agents コマンド（プライマリ） — claude agents を実行して、CLIで認識されている全エージェント（ユーザーエージェント、プラグインエージェント（例：ecc:architect）、組み込みエージェント）を取得します。これにより、パス設定なしでECCマーケットプレイスのインストールを自動的にカバーします。
2. ファイルグロブ（フォールバック、エージェントコンテンツ読み取り用） — エージェントマークダウンファイルは以下から読み取られます。
   • ./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 の実行とファイル場所の調査後、エージェントが見つからない場合は、ユーザーに「エージェントが見つかりません。claude agents を実行して設定を確認してください。」と通知し、停止します。

ステップ 2：ドメインメニューを表示

利用可能なエージェントドメイン：
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

ドメインを選択するか、特定のエージェントを指定してください（例：「1,3」または「security + seo」）：

• エージェントが0のドメインはスキップします（空のディレクトリ）
• ドメインごとのエージェント数を表示します

ステップ 3：選択を処理

柔軟な入力を受け付けます。

• 数字：「1,3」はEngineeringとSalesのすべてのエージェントを選択
• 名前：「security + seo」は発見されたエージェントに対してあいまい一致
• 「all from engineering」はそのドメインのすべてのエージェントを選択

5つを超えるエージェントが選択された場合、アルファベット順にリストし、ユーザーに絞り込みを依頼します：「N個のエージェントが選択されました（最大5個）。どれを保持するか選ぶか、'最初の5つ'と言って最初の5つをアルファベット順に使用してください。」

選択を確認します。

選択：Security Engineer + SEO Specialist
彼らに何を任せますか？（タスクを説明してください）：

ステップ 4：エージェントを並列起動

1. 選択された各エージェントのマークダウンファイルを読み取る
2. まだ提供されていない場合、タスク説明を求める
3. Agentツールを使用してすべてのエージェントを並列起動します。
   • subagent_type: "general-purpose"
   • prompt: "{エージェントファイルの内容}\n\nタスク: {タスク説明}"
   • 各エージェントは独立して実行されます — エージェント間通信は不要
4. エージェントが失敗した場合（エラー、タイムアウト、空の出力）、インラインで失敗を記録し（例：「Security Engineer: 失敗 — [理由]」）、成功したエージェントからの結果で続行します

ステップ 5：結果を統合

すべての出力を収集し、統合レポートを提示します。

• エージェントごとにグループ化された結果
• 統合セクションで以下を強調表示：
  • エージェント間の一致点
  • 推奨事項間の矛盾や緊張関係
  • 推奨される次のステップ

1つのエージェントのみが選択された場合は、統合をスキップして出力を直接提示します。

ルール

• 動的な発見のみ。 エージェントリストをハードコードしないでください。ディレクトリ内の新しいファイルは自動的にメニューに表示されます。
• チームあたり最大5エージェント。 5を超えると効果が減少し、トークン使用量が過剰になります。選択時に強制します。
• 並列ディスパッチ。 すべてのエージェントが同時に実行されます — Agentツールの並列呼び出しパターンを使用します。
• 並列Agent呼び出し、TeamCreateではない。 このスキルは、独立した作業のための並列Agentツール呼び出しを使用します。TeamCreate（マルチエージェント対話のためのClaude Codeツール）は、エージェントが議論したり互いに応答したりする必要がある場合にのみ必要です。

例

ユーザー: チームビルダー

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はインラインスキーママークアップを必要とする。解決策： [...]
次のステップ： [...]