team-composition-patterns
作成者 wshobsonteam-composition-patterns は、Claude Code Agent Teams のマルチエージェントチーム設計に向けた判断スキルです。チーム規模の目安、subagent_type の選び方、表示モードの指針を提供します。この team-composition-patterns ガイドを使って、レビュー/デバッグ向けのプリセットチーム適用、役割の選定、タスク間でのチーム設定の標準化が行えます。
このスキルは78/100の評価で、運用ガイダンスが充実した堅実な掲載候補です。導入判断はしやすい一方、セットアップは自動化ではなく手動運用が前提になります。
- 「When to Use This Skill」の明確な利用シナリオと、チーム構成の規模目安が示されており、起動判断がしやすい。
- subagent_type を選ぶためのエージェントタイプ選定マトリクスと能力テーブルがあり、意思決定を支援する。
- レビュー/デバッグなどのプリセットチーム構成とタスクテンプレートが具体的で、一般的なワークフローの迷いを減らせる。
- SKILL.md にインストールやクイックスタートのコマンドがなく、導入にはガイダンスの手動解釈が必要。
- 抜粋では運用詳細が一部省略されている可能性があり、完全な手順は全ファイルの確認が必要。
team-composition-patterns スキル概要
team-composition-patterns は、Claude Code Agent Teams でのマルチエージェント設計を支援する意思決定スキルです。チーム人数の目安、agent type の選定、表示モードの選択までを整理し、レビュー・デバッグ・機能実装を再現性高く回すためのチーム構成を設計できます。場当たり的に「とりあえず数人起動」するのではなく、再利用可能なチーム編成を作りたいビルダーに最適です。
team-composition-patterns が決めるべきポイント
導入時のつまずきやすい3点（人数、subagent_type、表示モード）を明確にします。環境に応じて tmux / iTerm2 / in‑process を選べるようになります。
最適な利用シナリオと期待できる成果
コードレビュー、バグ調査、機能実装など、タスク横断で一貫したチーム構成を保ちたい場合に有効です。毎回ロール設計を考え直さず、プリセットを使って再利用したいチームに向きます。
汎用プロンプトとの違い
一般的な「チームを作って」プロンプトと違い、team-composition-patterns は人数のヒューリスティクス、プリセット構成、subagent_type を選ぶための意思決定マトリクスまで明文化しています。
不向きなケース
Claude Code Agent Teams を使っていない場合や、単一エージェントで済む簡単な作業しか行わない場合は、運用負荷が増えるだけで効果が出にくいです。
team-composition-patterns スキルの使い方
team-composition-patterns のインストールと入口
インストールは npx skills add https://github.com/wshobson/agents --skill team-composition-patterns。中核ガイダンスは plugins/agent-teams/skills/team-composition-patterns/SKILL.md にあります。
採用判断のために最初に読むべきファイル
まず SKILL.md を読み、次に subagent_type 選定のマトリクスがある references/agent-type-selection.md、プリセットチームとタスクテンプレートがある references/preset-teams.md を確認します。
入力として求められる情報
タスク種別（review/debug/feature/migration）、複雑度、制約（CI かローカルか）、書き込み権限の有無を渡します。これがチーム人数と subagent_type の選択に直結します。
ざっくりした目標を強いプロンプトに変える
弱い例：「このPRをレビューするチームを起動して」
強い例：「auth と caching を触る 6 ファイル差分をレビュー。セキュリティと性能を優先。ローカル環境。file:line 付きの指摘と修正案が必要。」
この粒度なら review プリセットとレビュー観点を正しく選べます。
チーム人数のヒューリスティクスで過不足を防ぐ
複雑度に応じてチームサイズを合わせます。単純（1–2）、中程度（2–3）、複雑（3–4+）。量が多いだけでなく、セキュリティ＋性能＋アーキテクチャのように複数軸がある時ほど人数が効きます。
agent type の意思決定マトリクスを使う
references/agent-type-selection.md を参照して subagent_type を選びます。例：コードレビュー → agent-teams:team-reviewer、バグ調査 → agent-teams:team-debugger、編集不要のアーキテクチャ探索 → Plan / Explore。
まずはプリセットのチーム構成を使う
review/debug のプリセットチーム定義が最短で価値を出せます。役割・観点・タスクテンプレートが揃っており、各エージェントの軸と出力形式が明確です。
環境に合わせて表示モードを選ぶ
複数出力を同時に見たいなら tmux。軽量に運用したいなら iTerm2 や in‑process が摩擦を減らします。
team-composition-patterns の推奨ワークフロー
- タスク種別と複雑度を分類
- プリセットまたは目的に合わせたカスタムチームを選択
- 各ロールの subagent_type を割り当て
- 環境に合わせて表示モードを決定
- 各メンバーに構造化したタスクテンプレートを渡す
team-composition-patterns スキル FAQ
team-composition-patterns は Claude Code Agent Teams 専用ですか？
はい。subagent_type や表示モードなど Agent Teams の概念を前提にしています。別環境では実用性が落ちます。
通常の「チーム作成」プロンプトとどう違いますか？
人数決定のルール、agent type 選択のマトリクス、テンプレ付きのプリセットチームがある点が大きな違いです。汎用プロンプトには通常ありません。
初心者でも使えますか？
プリセットを使う限りは使いやすいです。決定マトリクスは密度が高いものの、探索役に書き込み権限を与えるといったミスを防げます。
使わない方がいいのはどんなとき？
単発でリスクの低い作業なら、汎用エージェント1人で十分です。チーム運用の調整コストが上回る可能性があります。
迁移や監査などの独自ワークフローにも対応しますか？
対応します。非標準ワークフローも想定されており、観点を組み合わせて subagent_type を選ぶことでカスタム構成を組めます。
team-composition-patterns スキルを改善する方法
より良いチーム設計のためにタスク観点を明確化する
レビュー観点（security, performance, architecture, testing）を指定してください。観点が明確だとプリセットのレビューロールに素早くマッピングでき、重複が減ります。
典型的な失敗パターンを避ける
失敗例：subagent_type を誤る（編集が必要なのに Plan を選ぶ）。解決策は、書き込みが必要かどうかを明示し、決定マトリクスを使うことです。
入力コンテキストを強化して出力精度を上げる
「multi-file change」「cross-cutting concern」「CI-only environment」などのスコープ情報を入れると、推奨チーム人数と表示モードが適切に変わります。
最初の提案後に反復する
浅い結果なら欠けている観点（例：accessibility）を追加するか、人数を+1します。出力が冗長なら人数を減らすかスコープを絞ります。
組織向けの再利用テンプレートを作る
references/preset-teams.md のタスクテンプレートを、リポジトリの規約（ファイルパス、出力形式、Severity など）に合わせて調整します。team-composition-patterns を安定した社内運用に変換できます。
team-composition-patterns を Agent Orchestration の判断に使う
複数タスクを並行させる際は、reviewer / debugger / implementer / lead の役割と能力の配分を統一するためにこのスキルを使います。各ストリームに適切な組み合わせを確実に配置できます。