web-research

网页调研技能

调研流程

第 1 步：创建并保存调研计划

在委派子 Agent 之前，你必须：

1. 创建调研文件夹：在当前工作目录下创建一个专用文件夹，用于整理所有调研文件：

   mkdir research_[topic_name]
   

   这样可以保持文件有序，避免工作目录杂乱。

2. 分析调研问题：将其拆分为彼此独立、互不重叠的子主题

3. 编写调研计划文件：使用 write_file 工具创建 research_[topic_name]/research_plan.md，内容包括：

   • 核心调研问题
   • 2-5 个需要调查的具体子主题
   • 每个子主题预期获得的信息
   • 结果将如何综合

规划指南：

• 简单事实查找：1-2 个子主题
• 对比分析：每个对比要素 1 个子主题（最多 3 个）
• 复杂调查：3-5 个子主题

第 2 步：委派调研子 Agent

针对计划中的每个子主题：

1. 使用 task 工具创建调研子 Agent，并提供：

   • 清晰、具体的调研问题（不使用缩写）
   • 将结果写入文件的指令：research_[topic_name]/findings_[subtopic].md
   • 预算：最多 3-5 次网页搜索

2. 最多并行运行 3 个子 Agent，以提高调研效率

子 Agent 指令模板：

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 步：综合调研结果

所有子 Agent 完成后：

1. 查阅本地保存的调研结果文件：

   • 先运行 list_files research_[topic_name]，查看已生成的文件
   • 然后使用 read_file 读取文件路径（例如 research_[topic_name]/findings_*.md）
   • 重要：read_file 仅用于读取本地文件，不能用于 URL

2. 综合信息：撰写一份全面的回答，要求：

   • 直接回答原始问题
   • 整合所有子主题的见解
   • 引用具体来源及其 URL（来自调研结果文件）
   • 指出存在的信息缺口或局限性

3. 撰写最终报告（可选）：如有需要，使用 write_file 创建 research_[topic_name]/research_report.md

注意：如需从 URL 获取额外信息，请使用 fetch_url 工具，而不是 read_file。

最佳实践

• 先规划再委派：始终先编写 research_plan.md
• 子主题清晰：确保每个子 Agent 的范围明确且互不重叠
• 基于文件的沟通：让子 Agent 将结果保存到文件中，而不是直接返回
• 系统化综合：在生成最终回答之前，先阅读所有调研结果文件
• 适度停止：避免过度调研；每个子主题通常 3-5 次搜索即可满足需求