Claude Code Atlas
#10

エージェントチームの役割分担設計

上級

良いチーム設計の3原則を学び、役割分担・コスト最適化・向いていないタスクの見極めを習得します。

座学

この講座で学べること

  • 「1人1仕事」の役割分担でAgent Teamsを効果的に設計する方法を理解する
  • Claude Code自身に役割分担の相談ができることを知る
  • 2人チームで月次レポートを自動作成する実践的なワークフローを習得する
  • /usageでAgent Teamsのトークン消費を確認してコスト最適化できる

エージェントチームをうまく動かすには、各エージェントに「この人はこれだけやる」と役割をはっきり決めることが大事です。何でもこなす万能型にすると、どこかで詰まったときに原因が分からなくなります。

たとえばリサーチャー(情報を集めてファイルに書く)とレポーター(その情報を読んで読みやすく整える)に分けると、両方が何をすればいいか迷わず動けます。役割が曖昧だと「Aがやるか、Bがやるか」で詰まってしまうので、1人1仕事を意識して分けましょう。作業の流れが明確になると、結果の質もぐっと上がります。

設計でとくに意識したいのは「誰が何をするか」を自然な言葉で指示することです。Claude Code自身に「どう分ければ効率的か」を相談するのが一番手軽な始め方です。

エージェントチームの役割一覧

📋

プランナー

タスクを分解・優先順位付け

全体設計リソース配分スケジューリング

エグゼキューター

実際の処理・ファイル操作を担当

コード実行ファイル操作API呼び出し
🔍

レビュアー

出力の品質チェック・修正提案

エラー検出品質評価フィードバック
📊

リポーター

結果をまとめて人間に報告

サマリー作成可視化通知送信

役割分担設計のポイント

  • 1エージェント1責務

    複数の役割を1つのエージェントに持たせない

  • インターフェースを明確に

    エージェント間のデータ形式をあらかじめ決める

  • 失敗を前提に設計

    エージェントが失敗したときの再試行・代替処理を用意する

「Sonnetモデルを使ってください」は必ずチーム指示に含めましょう。省略するとOpusが起動してトークンを大量消費します。

実践手順

Agent Teamsで役割分担を相談する

どんな役割に分ければ効率的かはClaude Code自身に相談するのが一番です。以下のように聞いてみましょう。

bash
私は週に1回「月次レポート」を作っています。
手順は:
1. 先週の業務記録ファイルを読む
2. 主な成果と課題をまとめる
3. 来週の目標を書く
4. フォーマットを整えてレポートファイルに保存する

この作業をエージェントチームで自動化するとしたら
何人チームでどんな役割分担が最適か提案してください

Claude Codeが役割分担を提案してくれます。その提案をもとに次のステップでチームを動かします。

実際にチームで月次レポートを作る

上級講座9で有効化したAgent Teamsを使います。まず練習用フォルダを準備してAgent Teamsを起動してください。

PowerShell で実行

powershell
cd $env:USERPROFILE\Desktop
mkdir report-team-test
cd report-team-test
claude --teammate-mode in-process

起動したら以下のチーム指示を出してください

bash
2人のチームで月次レポートを作成してください。
チームメンバーはSonnetモデルを使ってください。

担当A(リサーチャー):
「業務記録.txt」というファイルを作成して
「今月の主な出来事:Claude Code上級講座を完了した」
「課題:Hooksの設定に時間がかかった」
「来月の目標:Agent Teamsを業務で活用する」
と書いてください。

担当B(レポーター):
担当Aが作った「業務記録.txt」を読んで
「月次レポート.txt」として
見やすいレポート形式にまとめてください。
担当Aの作業完了を待ってから開始してください。

「Sonnetモデルを使ってください」は必須の一言です。 省略すると Opus が起動してトークンを大量消費します。

2人のエージェントが役割分担して順番に作業する様子が確認できます。Shift+↑↓でメンバーを切り替えてそれぞれの作業ログを確認してみてください。

コスト最適化を確認する

Agent Teamsのコストを確認する習慣をつけましょう。以下のコマンドでトークン使用量を確認してください。

bash
/usage

チームメンバーが多いほどトークン消費が増えます。今回の2人チームの消費量を覚えておいて、次回3人チームと比較するとコスト感覚が身につきます。

確認チェック

講座を終える前に、以下の項目を確認しましょう。

関連講座

「確認チェック」の全項目にチェックを入れると完了できます