チームビルダー

オンデマンドで AI エージェントチームを閲覧・組み合わせるための対話的メニュー。フラット構造またはドメイン別サブディレクトリで整理されたエージェント集合に対応。

ユースケース

• 複数のエージェントロール（markdown ファイル）があり、特定のタスク用にどのエージェントを使用するか選択したい
• 異なるドメイン（例：セキュリティ + SEO + アーキテクチャ）から臨時にチームを構成したい
• 決定前に利用可能なエージェントを閲覧したい

前提条件

エージェントファイルは、ロールプロンプト（アイデンティティ、ルール、ワークフロー、成果物）を含む markdown ファイルである必要があります。最初の # Heading がエージェント名として使用され、最初の段落が説明として使用されます。

フラット構造とサブディレクトリ構造の 2 つのレイアウトに対応：

サブディレクトリレイアウト — ドメインはフォルダ名から推測：

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

設定

エージェントディレクトリは順序に従って検索され、結果はマージされます：

1. ./agents/**/*.md + ./agents/*.md — ローカルプロジェクトエージェント（2 つの深度）
2. ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — グローバルエージェント（2 つの深度）

すべての位置の結果がマージされ、エージェント名で重複排除されます。同名の場合、ローカルプロジェクトエージェントがグローバルエージェントより優先されます。ユーザーがカスタムパスを指定した場合、そのパスが使用されます。

仕組み

ステップ 1：利用可能なエージェントの発見

上記の検索順序を使用してエージェントディレクトリでグローバル検索を実行。README ファイルは除外。見つかった各ファイルについて：

• サブディレクトリレイアウト： 親フォルダ名からドメインを抽出
• フラット構造レイアウト： すべてのファイル名プレフィックス（最初の - の前のテキスト）を収集。プレフィックスが 2 つ以上のファイル名に出現する場合のみドメイン適格（例：engineering-security-engineer.md と engineering-software-architect.md は両方 engineering で始まる → Engineering ドメイン）。ユニークなプレフィックスを持つファイル（例：code-reviewer.md, tdd-guide.md）は "General" カテゴリに分類
• 最初の # Heading からエージェント名を抽出。見出しが見つからない場合、ファイル名から名前を導出（.md を削除、ハイフンをスペースに置換、タイトルケースに変換）
• 見出しの後の最初の段落から 1 行の説明を抽出

すべての位置の検索後にエージェントファイルが見つからない場合、ユーザーに通知："エージェントファイルが見つかりません。確認済みパス：[検索したパスリスト]。期待：これらのディレクトリ内の markdown ファイル。" その後停止。

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

利用可能なエージェントドメイン：
1. エンジニアリング — ソフトウェアアーキテクト、セキュリティエンジニア
2. マーケティング — SEO スペシャリスト
3. セールス — ディスカバリーコーチ、アウトバウンドストラテジスト

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

• エージェント数がゼロのドメイン（空ディレクトリ）はスキップ
• 各ドメインのエージェント数を表示

ステップ 3：選択を処理

柔軟な入力を受け入れ：

• 数字："1,3" でエンジニアリングとセールスのすべてのエージェントを選択
• 名前："security + seo" で発見されたエージェントにあいまい一致を実行
• "all from engineering" でそのドメイン内のすべてのエージェントを選択

選択したエージェントが 5 個を超える場合、アルファベット順で列挙し、ユーザーに範囲を絞るよう要求："N 個のエージェント（最大 5 個）を選択しました。どのエージェントを保持するか選択するか、'first 5' と言ってアルファベット順の最初の 5 個を使用してください。"

選択を確認：

選択：セキュリティエンジニア + SEO スペシャリスト
彼らはどのタスクに焦点を当てるべきですか？（タスクを説明してください）

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

1. 各選択したエージェントの markdown ファイルを読み込む
2. まだ提供されていない場合、タスク説明を入力するよう促す
3. Agent ツールを使用してすべてのエージェントを並列起動：
   • subagent_type: "general-purpose"
   • prompt: "{agent file content}\n\nTask: {task description}"
   • 各エージェントは独立して実行 — エージェント間通信は不要
4. エージェントが失敗した場合（エラー、タイムアウト、または出力が空）、インラインで失敗を記載（例："Security Engineer: failed — [原因]"）し、成功したエージェントの結果の処理を続行

ステップ 5：結果を統合

すべての出力を収集し、統一されたレポートとして提示：

• エージェント別の結果グループ化
• 統合セクションは以下をハイライト：
  • エージェント間のコンセンサス
  • 推奨事項間の矛盾または対立
  • 推奨される次のステップ

1 つのエージェントのみが選択されている場合、統合セクションをスキップして出力を直接提示。

ルール

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

例

User: team builder

Claude:
利用可能なエージェントドメイン：
1. エンジニアリング (2) — ソフトウェアアーキテクト、セキュリティエンジニア
2. マーケティング (1) — SEO スペシャリスト
3. セールス (4) — ディスカバリーコーチ、アウトバウンドストラテジスト、提案ストラテジスト、セールスエンジニア
4. サポート (1) — エグゼクティブサマリー

ドメインを選択するか、特定のエージェントを指定してください：

User: security + seo

Claude:
選択：セキュリティエンジニア + SEO スペシャリスト
彼らはどのタスクを処理すべきですか？

User: リリース前に Next.js e コマースサイトをレビューしてください

[2 つのエージェントが並列起動し、各自の専門知識をコードベースに適用]

Claude:
## セキュリティエンジニアの発見
- [発見内容...]

## SEO スペシャリストの発見
- [発見内容...]

## 統合分析
両エージェントが合意：[...]
対立点：セキュリティ推奨事項の CSP がインラインスタイルをブロック、SEO はインラインスキーママークアップが必要。解決策：[...]
次のステップ：[...]