読み込み中

サブエージェントを効果的に使う

レッスン 410 分
読み込み中

サブエージェントを効果的に使う

要約文字起こし

サブエージェントの作り方と、それをうまく設計する方法はすでに理解しています。では問題は、サブエージェントが実際に役立つのはどんなときで、逆に邪魔になるのはどんなときか、ということです。その違いは一つのことに集約されます――中間作業の内容がメインスレッドにとって重要かどうかです。

サブエージェントが真価を発揮する場面

サブエージェントは、探索作業と実行作業が分離できる場合に最も効果を発揮します。タスクの各ステップが前のステップで発見した内容に依存している場合は、その作業をメインスレッドで行うべきです。しかし、答えさえ得られればよく、そこに至る過程を気にする必要がない場合は、委任しましょう。

サブエージェントは次のようなタスクで優れた力を発揮します。

  • 結果だけが必要で、それがどのように見つかったかの逐一の経過は不要な場合
  • 探索作業がメインスレッドのコンテキストを散らかしてしまう場合
  • タスクが新鮮な視点やカスタムのシステムプロンプトから恩恵を受ける場合

リサーチタスク

リサーチはサブエージェントの典型的な使用例です。見慣れないコードベースで認証がどのように機能しているかを調査する場合を考えてみましょう。メインスレッドが知る必要があるのは、JWTがどこで検証されているかであり、その過程で検索されたすべてのファイルを見る必要はありません。

リサーチ用のサブエージェントは、何十ものファイルを読み、関数呼び出しをたどり、さまざまなコードパスを探索できます。そうした探索作業はすべてサブエージェントのコンテキスト内にとどまります。メインスレッドが受け取るのは、次のようなすっきりした要約です。

JWT validation happens in middleware/auth.js line 42,
called from the Express router in route/api.js

サブエージェントが重労働を引き受けてくれたわけです。メインスレッドは、前に進むために必要なものだけを正確に受け取ります。

コードレビュー

Claudeは、コードが他の誰かによって書かれたものとして提示されたときの方が、より効果的にレビューを行います。メインスレッドで何ターンもかけて機能を構築した場合、同じスレッドにそのレビューを依頼すると、弱いフィードバックしか得られないことがよくあります。Claudeはその作成に関わっているため、新鮮な目で見ることが難しいのです。

レビュー担当のサブエージェントは、変更内容を別のコンテキストで確認します。git diff を実行し、変更されたファイルを読み、そのコードがどのように書かれたかという経緯を知らないまま、専門的なレビュー基準を適用します。この分離によって、プロジェクト固有のレビュー基準をサブエージェントのシステムプロンプトにエンコードすることもでき、チーム全体で一貫したレビュー基準を確保できます。

カスタムシステムプロンプト

Claude Codeのデフォルトのシステムプロンプトは、簡潔でコードに焦点を当てた応答を重視しています。これはコーディングには非常に有効ですが、すべての用途に適しているわけではありません。

カスタムシステムプロンプトによって、サブエージェントがメインスレッドよりも本当に優れた結果を出せる2つのケースを紹介します。

  • コピーライティング用サブエージェント -- トーン、対象読者、スタイルについての指示を与えます。Claude Codeのデフォルトプロンプトは簡潔な技術文書寄りになりがちですが、それはランディングページやメールキャンペーンに求められるものとは異なります。コピーライティング用サブエージェントには、文体や構成についてまったく異なる指示を与えることができます。
  • スタイリング用サブエージェント -- システムプロンプトの中で、まずデザインシステムのファイルを読むよう指示しておきます。そうすれば、CSSを書き始める前に、カラー変数、スペーシングの規則、コンポーネントのパターンを把握できます。

サブエージェントが逆効果になる場合

サブエージェントを起動することのオーバーヘッド――その作業をメインスレッドから隠し、発見内容を要約に圧縮すること――は、サブエージェントがメインスレッドにはできないことを行う場合にのみ意味を持ちます。注意すべき一般的なアンチパターンが3つあります。

専門家を名乗らせる

専門性を主張するサブエージェントはほとんど役に立ちません。「あなたはPythonの専門家です」や「あなたはKubernetesのスペシャリストです」といったプロンプトは、何の価値も付加しません。なぜなら、Claudeはすでにその知識を持っているからです。いわゆる専門家サブエージェントにできて、メインスレッドが直接できないことは何もありません。

逐次パイプライン

逐次的なサブエージェントのパイプラインは問題を引き起こします。バグを再現するエージェント、それをデバッグするエージェント、それを修正するエージェントという3つのエージェントからなるフローを考えてみましょう。パイプラインは、タスクが本当に独立している場合にはうまく機能します。しかし、各ステップが前のステップでの発見に依存している場合――バグ修正はほぼ常にそうです――うまくいきません。エージェント間の引き継ぎで情報が失われてしまいます。

テストランナー

テストランナー用のサブエージェントは、必要な情報を隠してしまう傾向があります。テストが失敗したときには、問題を診断するために完全な出力が必要です。「テストが失敗しました」とだけ返すサブエージェントでは、直接の出力であれば見えていたはずの詳細を得るために、追加のデバッグスクリプトを作成せざるを得なくなります。検証の結果、テストランナーのパターンはすべての構成の中で最も成績が悪いことが示されています。

判断のルール

サブエージェントを使うべきかどうかを判断するときは、自分自身に一つの問いを投げかけてください。中間作業の内容は重要か?

答えが「いいえ」――最終結果さえ得られればよい――であれば、サブエージェントに委任しましょう。答えが「はい」――途中で起きていることを見て、それに反応する必要がある――であれば、メインスレッドにとどめておきましょう。

サブエージェントを使うべき場面:

  • リサーチと探索
  • コードレビュー
  • カスタムシステムプロンプトが必要なタスク

サブエージェントを避けるべき場面:

  • 実質的な能力を付加しない「専門家」ペルソナ
  • 各ステップが前のステップに依存する多段階パイプライン
  • デバッグのために完全な出力が必要なテストの実行