サブエージェントを並列で走らせる設計

コース構成

このコースで学ぶこと

1. 01

   直列で書いてないですか

   Claude Code でエージェントを 3 つ走らせるとき、prompt 1 つで Task → Task → Task と直列に書いてしまいがち。独立した調査は並列に投げると体感速度が 3 倍になる。

   • “読み専”の調査は並列で投げて損なし
   • “書き” が混じる場合は順序保証が要る
   • メイン Claude は要約役に専念させる

   理解度チェック

   1. Q1.3 つの独立した調査タスクがあるとき、最も速く終わる投げ方は？

      A1 つずつ Task を直列に呼ぶB1 メッセージに 3 つの Task を並べて並列実行するCメイン Claude が 3 つを順番に自分で実行するDユーザーが 3 セッションを別ターミナルで立ち上げる
   並列投入の指示の出し方
2. 02

   並列投入の指示の出し方

   Claude Code の Task tool は、1 つのメッセージに複数の tool_use を並べると並列実行になる。ユーザー側からは『〜と〜と〜を並列で調査して』と書くだけで、Claude が複数 Task を 1 メッセージにまとめて投げる挙動を取る。

   明示的に『並列で』『同時に』と指示すると、Claude は 1 メッセージに 3〜5 個の Task tool_use を並べて投げる。直列で書きたい場合は『順番に』『〜してから〜』と書く。

   text

   ユーザー: 次の 3 つを並列で調査して、終わったら 1 つの表にまとめて：
     1. 認証フロー（src/auth/ 配下）
     2. 課金フロー（src/billing/ 配下）
     3. テスト構造（tests/ 配下）
     それぞれ subagent_type=Explore で、結論を 200 字以内で。
   
   → Claude は 1 メッセージに Explore × 3 を tool_use として並べて返す

   理解度チェック

   1. Q1.Claude に並列で複数 Task を走らせたいとき、プロンプトに含めると効くキーワードは？

      A「順番に」「〜してから」B「並列で」「同時に」C「丁寧に」「ゆっくり」D「自動で」「素早く」
   直列で書いてないですか結果のマージ戦略
3. 03

   結果のマージ戦略

   3 つのレポートが返ったあとに、メイン Claude が “矛盾点を見つけて表で返す” 役を担うとブレが出にくい。

   手を動かす

   0 / 3

   • 各エージェントには “200 字以内で要点だけ” と上限を指示
   • 重複する発見は 1 行にマージ
   • 矛盾は“どちらが正”を断言せず、確認方法を添える

   理解度チェック

   1. Q1.並列で複数の Subagent が出した結果に矛盾があった場合、メイン Claude に取らせるべき振る舞いは？

      A最初に返ってきたレポートを信じて他を捨てるBどちらかを Claude の独断で“正”と決めて他を黙殺するC矛盾点を提示し、どう確認すれば白黒つくかの方法を添えて返すD矛盾を平均値で丸めて 1 つの答えにする
   並列投入の指示の出し方失敗パターンと対策
4. 04

   失敗パターンと対策

   並列にすればするほど暴走時のコスト爆発も並列化する。max-turns と allowed-tools の制限を必ず添える。

   • 並列数は 3〜5 が現実的（多すぎると要約が破綻）
   • agent ごとに “失敗時の出力フォーマット” を決めておく
   • Anthropic Console の Workspace で月次 spend cap を必ず設定

   理解度チェック

   1. Q1.並列実行で“絶対に避けるべき”組合せは？

      ARead を 5 並列で投げるBEdit/Write を含む Task を並列で投げるCExplore Subagent を 3 並列で投げるDWebFetch を 4 並列で投げる
   結果のマージ戦略Skill 化と運用テンプレ
5. 05

   Skill 化と運用テンプレ

   “3 並列調査 → 1 マージ” のパターンは何度も使うので Skill 化する。テンプレ化で新人もすぐ使える。

   手を動かす

   0 / 3

   • Skill 名: parallel-explore / 説明: “3 観点を同時に調査するとき”
   • デフォルトの max-turns / allowed-tools を内蔵
   • 出力フォーマット（表 + 矛盾欄）を固定

   Lv.7 — エージェント自動化

   理解度チェック

   1. Q1.“3 並列調査”を Skill 化するときに、テンプレに必ず内蔵すべきものは？

      A並列数を 10 以上に増やすオプションBWrite 系ツールも並列で動くフラグCmax-turns と allowed-tools の既定値、固定の出力フォーマットD毎回ユーザーに並列数を聞き返す対話プロンプト
   失敗パターンと対策