web-research

Web Research スキル

調査プロセス

ステップ 1：調査計画の作成と保存

サブエージェントに委任する前に、必ず以下を行ってください。

1. 調査フォルダーを作成する - 現在の作業ディレクトリを基準にした専用フォルダーに、すべての調査ファイルを整理します。

   mkdir research_[topic_name]
   

   これによりファイルを整理でき、作業ディレクトリが散らかるのを防げます。

2. 調査の質問を分析する - 質問を、明確に区別された重複のないサブトピックに分解します。

3. 調査計画ファイルを作成する - write_file ツールを使って research_[topic_name]/research_plan.md を作成し、以下を記載します。

   • 主な調査の質問
   • 調査する具体的なサブトピックを 2～5 件
   • 各サブトピックで期待される情報
   • 結果を統合する方法

計画のガイドライン：

• 簡単な事実確認：サブトピックを 1～2 件
• 比較分析：比較要素ごとに 1 件（最大 3 件）
• 複雑な調査：サブトピックを 3～5 件

ステップ 2：調査サブエージェントに委任する

計画内の各サブトピックについて、以下を行ってください。

1. task ツールを使って調査サブエージェントを起動し、以下を指定します。

   • 明確で具体的な調査の質問（略語は使用しない）
   • 調査結果を research_[topic_name]/findings_[subtopic].md に書き込むよう指示
   • 予算：ウェブ検索は最大 3～5 回

2. 効率的に調査するため、サブエージェントを最大 3 つまで並行して実行します。

サブエージェントへの指示テンプレート：

Research [SPECIFIC TOPIC]. Use the web_search tool to gather information.
After completing your research, use write_file to save your findings to research_[topic_name]/findings_[subtopic].md.
Include key facts, relevant quotes, and source URLs.
Use 3-5 web searches maximum.

ステップ 3：調査結果を統合する

すべてのサブエージェントが完了したら、以下を行ってください。

1. ローカルに保存された調査結果ファイルを確認します。

   • 最初に list_files research_[topic_name] を実行して、作成されたファイルを確認します。
   • 次に、ファイルパス（例：research_[topic_name]/findings_*.md）を指定して read_file を使います。
   • 重要：read_file は URL ではなく、ローカルファイルに対してのみ使用してください。

2. 情報を統合する - 以下の要件を満たす包括的な回答を作成します。

   • 元の質問に直接回答する
   • すべてのサブトピックから得られた知見を統合する
   • 具体的な出典を URL とともに引用する（調査結果ファイルに記載されたもの）
   • 不足している点や限界を明らかにする

3. 最終レポートを作成する（任意） - 依頼された場合は、write_file を使って research_[topic_name]/research_report.md を作成します。

注：URL から追加情報を取得する必要がある場合は、read_file ではなく fetch_url ツールを使用してください。

ベストプラクティス

• 委任する前に計画する - まず必ず research_plan.md を作成してください。
• サブトピックを明確にする - 各サブエージェントの担当範囲が明確に区別され、重複しないようにしてください。
• ファイルベースで情報を共有する - サブエージェントには調査結果を直接返すのではなく、ファイルに保存させてください。
• 体系的に統合する - 最終回答を作成する前に、すべての調査結果ファイルを読んでください。
• 適切なところで終了する - 過剰に調査しないでください。通常、サブトピックごとに 3～5 回の検索で十分です。