web-research

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Web Research Skill

Web调研Skill

This skill provides a structured approach to conducting comprehensive web research using the

task

tool to spawn research subagents. It emphasizes planning, efficient delegation, and systematic synthesis of findings.

该Skill提供了一套结构化的方法，通过

task

工具生成调研子Agent，开展全面的网页调研。它强调规划、高效委派以及研究结果的系统性整合。

When to Use This Skill

何时使用该Skill

Use this skill when you need to:

Research complex topics requiring multiple information sources
Gather and synthesize current information from the web
Conduct comparative analysis across multiple subjects
Produce well-sourced research reports with clear citations

当你有以下需求时可使用该Skill：

调研需要多信息来源的复杂主题
从网页收集并整合最新信息
对多个主题进行对比分析
生成来源明确、带有清晰引用的调研报告

Research Process

调研流程

Step 1: Create and Save Research Plan

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

Before delegating to subagents, you MUST:

Create a research folder - Organize all research files in a dedicated folder relative to the current working directory:
```
mkdir research_[topic_name]
```
This keeps files organized and prevents clutter in the working directory.
Analyze the research question - Break it down into distinct, non-overlapping subtopics
Write a research plan file - Use the
```
write_file
```
tool to create
```
research_[topic_name]/research_plan.md
```
containing:
- The main research question
- 2-5 specific subtopics to investigate
- Expected information from each subtopic
- How results will be synthesized

Planning Guidelines:

Simple fact-finding: 1-2 subtopics
Comparative analysis: 1 subtopic per comparison element (max 3)
Complex investigations: 3-5 subtopics

在委派给子Agent之前，你必须完成以下操作：

创建调研文件夹 - 在当前工作目录下创建一个专用文件夹，用于整理所有调研文件：
```
mkdir research_[topic_name]
```
这样可以保持文件有序，避免工作目录杂乱。
分析调研问题 - 将其拆解为多个独立、不重叠的子主题
编写调研计划文件 - 使用
```
write_file
```
工具创建
```
research_[topic_name]/research_plan.md
```
，文件内容需包含：
- 核心调研问题
- 2-5个具体的待调研子主题
- 每个子主题的预期信息
- 研究结果的整合方式

规划指南：

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

Step 2: Delegate to Research Subagents

步骤2：委派给调研子Agent

For each subtopic in your plan:

Use the
task
tool to spawn a research subagent with:
- Clear, specific research question (no acronyms)
- Instructions to write findings to a file:
```
research_[topic_name]/findings_[subtopic].md
```
- Budget: 3-5 web searches maximum
Run up to 3 subagents in parallel for efficient research

Subagent Instructions Template:

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.

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

使用
task
工具生成调研子Agent，需指定：
- 清晰、具体的调研问题（避免使用缩写）
- 将研究结果写入文件的指令：
```
research_[topic_name]/findings_[subtopic].md
```
- 预算：最多3-5次网页搜索
最多并行运行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.

Step 3: Synthesize Findings

步骤3：整合调研结果

After all subagents complete:

Review the findings files that were saved locally:
- First run
```
list_files research_[topic_name]
```
  to see what files were created
- Then use
```
read_file
```
  with the file paths (e.g.,
```
research_[topic_name]/findings_*.md
```
  )
- Important: Use
```
read_file
```
  for LOCAL files only, not URLs
Synthesize the information - Create a comprehensive response that:
- Directly answers the original question
- Integrates insights from all subtopics
- Cites specific sources with URLs (from the findings files)
- Identifies any gaps or limitations
Write final report (optional) - Use
```
write_file
```
to create
```
research_[topic_name]/research_report.md
```
if requested

Note: If you need to fetch additional information from URLs, use the

fetch_url

tool, not

read_file

所有子Agent完成任务后：

查看本地保存的研究结果文件：
- 首先运行
```
list_files research_[topic_name]
```
  查看已创建的文件
- 然后使用
```
read_file
```
  工具读取文件路径（例如：
```
research_[topic_name]/findings_*.md
```
  ）
- 重要提示：
```
read_file
```
  仅用于读取本地文件，不可用于URL
整合信息 - 生成全面的回应，需包含：
- 直接回答原始调研问题
- 整合所有子主题的研究见解
- 从研究结果文件中引用具体来源及URL
- 指出研究中的任何空白或局限性
撰写最终报告（可选） - 如果有需求，使用
```
write_file
```
工具创建
```
research_[topic_name]/research_report.md
```

注意：若需从URL获取额外信息，请使用

fetch_url

工具，而非

read_file

。

Available Tools

可用工具

You have access to:

write_file: Save research plans and findings to local files
read_file: Read local files (e.g., findings saved by subagents)
list_files: See what local files exist in a directory
fetch_url: Fetch content from URLs and convert to markdown (use this for web pages, not read_file)
task: Spawn research subagents with web_search access

你可使用以下工具：

write_file：将调研计划和研究结果保存到本地文件
read_file：读取本地文件（例如子Agent保存的研究结果）
list_files：查看目录中的本地文件
fetch_url：从URL获取内容并转换为Markdown格式（用于网页内容，勿用read_file）
task：生成具备web_search权限的调研子Agent

Research Subagent Configuration

调研子Agent配置

Each subagent you spawn will have access to:

web_search: Search the web using Tavily (parameters: query, max_results, topic, include_raw_content)
write_file: Save their findings to the filesystem

你生成的每个子Agent都可使用以下工具：

web_search：通过Tavily进行网页搜索（参数：query, max_results, topic, include_raw_content）
write_file：将研究结果保存到文件系统

Best Practices

最佳实践

Plan before delegating - Always write research_plan.md first
Clear subtopics - Ensure each subagent has distinct, non-overlapping scope
File-based communication - Have subagents save findings to files, not return them directly
Systematic synthesis - Read all findings files before creating final response
Stop appropriately - Don't over-research; 3-5 searches per subtopic is usually sufficient

先规划再委派 - 务必先编写research_plan.md
子主题清晰明确 - 确保每个子Agent的研究范围独立、无重叠
基于文件的沟通 - 让子Agent将研究结果保存到文件，而非直接返回
系统性整合 - 在生成最终回应前，通读所有研究结果文件
适时停止调研 - 避免过度调研；每个子主题最多进行3-5次网页搜索即可