用途:当用户希望就某个具体问题做网络调研(收集多角度、可引用的证据)时使用,也可被其他技能以编程方式作为调研搭档调用。它不重塑研究问题,将输入问题视为最终版本,输出可审计:用户确认过的计划、各子主题发现文件,以及带引用支撑的综合报告。所有交付物都写在磁盘上,不以正文内联形式返回。
主要能力与流程:按固定四步执行。先写 plan.md,包含研究问题原文、1-5 个互不重叠的子主题、每个子主题要确立的内容、综合方式与预算;默认经计划评审门由用户确认(调用方传 auto_proceed: true 时跳过);随后最多并发启动 3 个子代理(每子主题一个),每个默认执行 3-5 次网络搜索并写入 findings/<slug>.md;最后综合生成 report.md,返回给调用方前运行校验清单。
引用要求:每条论断必须带 url、title、excerpt(逐字摘录),可选 retrieved_at、source_type;不得编造缺失元数据,行内用 [^n] 脚注。report.md 固定四节:TL;DR、Findings、Gaps & Limitations、Sources,其中 Gaps & Limitations 始终必填。
输出位置:调用方给出 output_dir 则原样使用,否则默认为 .beagle/research/<YYYY-MM-DD>-<topic-kebab>/;已有 plan.md 或 report.md 且未传 refresh 时拒绝覆盖,refresh: true 会先归档旧内容。
使用方式与限制:输入字段为 research_question(必填)、output_dir、auto_proceed、refresh。前置条件为环境具备网络搜索能力,否则不写任何文件并按失败模式返回结构化错误;页面抓取为可选项,不属于该门禁。部分子代理失败时继续并记录缺口,不中止。其范围不包括代码库查询、本地文件搜索、实现对比评估(用 llm-judge)、付费或需登录的抓取、问题重塑与教练式引导、长时或定时任务、多语言研究、跨调用缓存去重。子代理简报、引用模式、报告模板、失败模式与搭档调用契约见 references 下的参考文件。