サブエージェントで記事原稿を並列執筆する方法(共通ブリーフ)
要点
小カテゴリ1つ(8記事)ごとにサブエージェントを1つ立て、共通ブリーフで原稿を書かせる。戻り値はファイルパスとH2一覧だけにして本文を返させない。文字数は len.ps1 で確認する。
やり方
- 小カテゴリ1つ=8記事を1エージェントに任せる(例: 「Write GA4の導入と設定 articles」)。1エージェントあたり約7〜9万トークン、4〜5分。
- 共通ブリーフ(
knowledge/tools/guidepocket-scripts/BRIEF.md)を渡す。内容: 出力形式(<!--title-->など)、使ってよいHTML要素、文章ルール、見本、自己レビュー項目。 - 担当カテゴリの記事タイトル(一字一句)と保存先ディレクトリを指定する。
- 戻り値は「8ファイルのパスと各記事のH2一覧」だけにし、本文は返させない(メイン側の消費を抑える)。
仕上げ
len.ps1で文字数を確認(1,600〜2,300字の範囲外に<<<)。足りない記事は section を追加して加筆する。- 最終的に人(またはメイン)が一部を読んで、重複・不自然な表現を直す。
- 既存記事との類似度を確認する(新カテゴリでは既存と最大0.10程度だった)。
並列生成の注意
- カテゴリ間の重複: エージェントは他のエージェントの原稿を見ていない。ブリーフに「他カテゴリで扱う内容(踏み込まない)」を書く。
- トーン・表記のずれ: 見本(既存記事)と表記ルール(数字は半角、WEB表記など)を必ず渡す。
- 待機: 完了通知が来るまで結果は無い。待っている間に同じカテゴリを別に作り始めない(Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ))。
- 途中停止: どのファイルまで書けたかを確認し、欠けた記事だけ作り直す。
- 品質管理は全体の流れの中で行う(AIで大量ページを作るときの品質管理(小さく試す・テンプレート固定・自動検証・抜き取り確認))。
注意
- Bash のヒアドキュメントで原稿を書くときは1回1〜2記事(約12KB)まで。大きいと
unexpected EOFで失敗する。 - 水増し・同じ説明の繰り返しは禁止。短めでも内容が薄くならないことを優先した結果、目安1,700字を少し下回る記事は許容された。