Claude Code サブエージェントと Agent Teams: 実用的なガイド

サブエージェント、Agent Teams、オーケストレーション: 必要なときに、実際にどういう意味か、スプロール時にコントロールに滞在する方法.

「試薬」「Agent Teams」「orchestration」という単語が見え、何かが見つからない場合は疑問に思います。短い回答:タスクのほとんどについて、いいえ。しかし、大きな仕事では、はい、それは理解価値があります.

Jargon を使わずにアンコールしましょう.

実際にサブエージェントが何であるか

Subagentは、独自のコンテキスト、独自のプロンプト、および独自のツールの権限を持つ専門アシスタントです.

メインエージェントがよく定義されたサブタスクをヒットすると、サブエージェントに委任します。そのサブエージェントは独自のコンテキストウィンドウで動作し、そのジョブを実行し、結果だけを返します。主要なエージェントは、そのコンテキストを汚染する完全な歴史を得ることができません, それは結論を得ます.

つまり、メインエージェントのコンテキストを清潔に保ちます。代わりに、ファイル検索の50,000トークンでドローイングする1つのエージェントの代わりに、検索を行い、3つの便利な行を報告するサブエージェントがあります.

プロジェクトの.claude/agents/フォルダにサブエージェントを宣言します。それぞれに名前、それを使用するときに言う記述があり、システムプロンプト.

---
name: test-writer
description: Use when tests need to be written or fixed
---
You write tests. You aim for edge-case coverage,
not the happy path. You never touch production code.

Agent Teams、次のステップアップ

Agent Teamsは、Claude Codeに組み込まれたマルチエージェントのオーケストレーターです。実験的ではなく、デフォルトでは無効になっています.

アイデア: リードエージェントは、大きなタスクを分割し、各ピースを専門家のエージェント(独自のモデル、プロンプト、ツール)に委任し、専門家は共有ファイルシステム上で並行して作業し、結果はリードに戻る.

もし「専門家に委任」がサブエージェントのように聞こえるなら、それは正常です。 Agent Teamsは、複数のエージェントを本当に並行して実行するすべての方法を押し出したという考えです.

MulticlaudeやGas Townなどのサードパーティのオーケストレータがあります。彼らは、あなたが始めるとき、彼らは彼らに良い出発点を作るものです。彼らはあなた自身の習慣を築いたまであなたのために決めます.

必要なとき(とない場合)

明確にしましょう: 複数のエージェントのオーケストレーションは、エージェントアシストタスクの95%に意味がありません。毎日の仕事のほとんどのために、単一の代理店はより速く、より簡単です.

現在、マルチエージェントは、大規模なプロジェクトを攻撃する高価で実験的な方法です.

お問い合わせ

プロジェクトは、異なるファイルに触れる、完全に独立した部分に分割します.
一つのコンテクストウィンドウは、全体を保持することはできません.
幅広いリファクタやリポ全体での移行を並列化したい.

バグ修正、集中機能、または1頭に収まるものは必要ありません.

トラップは1つのエージェントが5分で行う10のエージェント「チーム」をスピンアップしています。タスクが要求されることはありません並列主義のためにトークンと複雑さで支払います.

実際の問題:可視性

ここまで話せなかったのは十分です。複数のサブエージェントまたはエージェントチームを実行すると、スレッドが失われます.

5つの専門家にリードが委任されます。作業は? 終了するか。決定を待っていますか? ターミナルでは、テキストをスクロールする壁が見え、誰が何をやっているのかは分かりません.

ビジュアルダッシュボードがすべてを変化させる場所です。 AgentsRoomは、各エージェントと各サブエージェントを独自のタイルとして表示し、そのステータスをスペルアウトします。あなたは委任が起こるのを見て、あなたは誰があなたの返信を待っている、あなたは誰がクラッシュしたかを参照してください。テキストの壁は読みやすい地図になります.

そのビューがなければ、マルチエージェントのオーケストレーションは、管理不能な日を一日に監視できる印象的なデモです。使う道具になります.