agent-teams

エージェントチーム構成スキル

Claude Code エージェントチームの構成とオーケストレーションに関する専門知識があります。ユーザーのタスクが複数セッションでの並行作業に適している場合に、この知識を活用してください。

エージェントチームはデフォルトで無効です。ユーザーがセッション開始時に CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を明示的に設定している場合にのみ使用してください。それ以外の場合は通常のサブエージェントを使用し、求められていないのにチームを提案しないでください。

エージェントチームが適する場合

チームが有効になっている場合、次のようなタスクに適しています。

• ユーザーが包括的なコードレビューを依頼した場合（3 人のレビュー担当者によるチームを提案してください）
• 複数のレイヤーにまたがる作業（フロントエンド＋バックエンド＋データベース）
• ユーザーが根本原因の不明なバグを説明した場合（競合する仮説の調査を提案してください）
• ユーザーが複数の技術やアプローチの評価を希望する場合（リサーチパネルを提案してください）
• 独立した、ファイル単位で分けられるワークストリームに明確に分割できるタスク

次の場合は、エージェントチームを提案しないでください。

• タスクが逐次的、または同じファイルの編集を伴う場合
• 1 つのセッションまたはサブエージェントで十分な場合
• 調整のオーバーヘッドがメリットを上回る場合
• ユーザーが厳しいトークン予算内で作業している場合

チームのテンプレート

フルレビュー（チームメイト 3 人）

セキュリティレビュー担当者＋パフォーマンスレビュー担当者＋正確性レビュー担当者（エッジケース、エラーパス、呼び出し元）。 それぞれが独立してレビューし、その後リードが指摘事項を統合します。

機能開発（チームメイト 3 人）

アーキテクト（計画の承認が必要）＋実装担当者＋レビュー担当者。 最初にアーキテクトが計画し、次に実装担当者が作業し、レビュー担当者が差分を確認します。

デバッグチーム（チームメイト 3～5 人）

各チームメイトが異なる仮説を調査します。 チームメイト同士が互いの仮説に異議を唱える、敵対的な議論形式です。

クロスプラットフォーム（チームメイト 3 人）

iOS 開発者＋Android 開発者＋共有アーキテクト。 各プラットフォームのチームメイトが、それぞれ自身のディレクトリを担当します。アーキテクトが API コントラクトを調整します。

フルスタック（チームメイト 3 人）

フロントエンド＋バックエンド＋データベース。 各レイヤーの担当ファイルを明確に分けます。まず API コントラクトについて調整します。

リサーチパネル（チームメイト 3 人）

シンプルさの提唱者＋パフォーマンスの提唱者＋悪魔の代弁者。 それぞれ異なる観点から評価し、その後、結果を統合します。

起動プロンプトの定型

すべての起動プロンプトには、次の内容を含めてください。

1. 役割：「あなたは、[領域]を担当する[役割]のチームメイトです」
2. ファイル：「[ディレクトリ]内のファイルを担当します。担当範囲外のファイルは変更しないでください」
3. 注力点：「具体的には、[詳細]を確認／実装してください」
4. コンテキスト：「[チームメイトに必要なプロジェクト固有の情報]」
5. 成果物：「[形式]で調査結果を報告してください／[具体的な出力]を実装してください」

クロスプラットフォームへの配慮

• macOS と Linux：完全サポート（プロセス内＋tmux の分割ペイン）
• Windows：プロセス内モードのみ（auto 設定時は自動）
• 自動検出には常に --teammate-mode auto（デフォルト）を使用してください

関連ドキュメント

• ~/.claude/docs/AGENT-TEAMS.md - 例を含む完全ガイド
• ~/.claude/docs/reference/workflows/agent-teams.md - 意思決定フレームワーク
• ~/.claude/commands/assemble-team.md - チームをすばやく編成するコマンド