Claude Codeのサブエージェントの使い方(並列作業・分担・統合と、同じファイル・重複・品質差・消費・待機の注意)
要点
サブエージェントは独立した作業(小カテゴリごとの原稿、分野ごとの調査・分類・比較)を並列にするのに向く。担当ファイルを分けて同じファイルを触らせない、共通ブリーフを渡す、戻り値は要点だけ、最後にメインで統合と検査をする。大量生成では生成役と検査役を分ける。
記事原稿の並列執筆の具体例は サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ)(confirmed)。
向いている作業
| 作業 | 分け方の例 |
|---|---|
| 大量記事生成 | 小カテゴリ1つ(8記事)=1エージェント |
| 調査 | 分野ごと・サイトごと・資料ごとに担当 |
| 分類・整理 | ファイル群を範囲で分けて分類させ、結果の表だけ返させる |
| 比較 | 候補ごとに同じ観点で評価させる |
| 検査 | 生成とは別のエージェントに、基準表で検査させる |
互いの結果に依存する作業(前の結果を見て次を決める)は、並列にせず順番に行う。
注意点
- 同じファイルを複数エージェントに触らせない: 担当するファイル・フォルダを分ける。共有ファイル(一覧・索引)の更新は最後にメインが1回だけ。
- 最終統合が必要: 各エージェントの結果をメインで集め、全体の整合(重複・表記・リンク)を確認する。
- 重複生成: 他のエージェントの内容は見えない。ブリーフに「他の担当が扱う内容」「踏み込まない範囲」を書く。
- 品質差: エージェントごとに文体・長さがずれる。共通ブリーフ・見本・表記ルール・自己チェック項目を渡す。
- 大量消費: エージェントごとに読み込み・生成の消費がある。戻り値は「ファイルパスと見出し一覧」など要点だけにし、本文を返させない(Claude消費量を抑える検査・作業ルール)。
- 待機状態: 結果は完了通知が来るまでない。待っている間に同じ作業を別に始めない。止まったら、どのファイルまでできたかを確認して不足分だけ作り直す(Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ))。
- 数は必要な分だけ。細かく分けすぎると統合の手間と消費が増える。
大量ページ制作では生成と検査を分ける
- 生成: テンプレート固定で中身だけをサブエージェントに書かせる。
- 機械検査: 文字数・禁止タグ・類似度・リンクをスクリプトで確認(AIで大量ページを作るときの品質管理(小さく試す・テンプレート固定・自動検証・抜き取り確認))。
- 抜き取り確認: 人(またはメイン)が一部を読む。
- 不合格分だけ作り直す。
生成したエージェント自身に「問題ないか」を確認させるだけでは見落としが残る。