用途:web-research 用于执行并行、多角度的网络搜索研究,把结果与本地上下文结合,只返回相关发现,每条都附带来源 URL。
主要能力:提供四种深度模式。scan 用于快速回答或验证,输出 1 页纸,含前 3 条发现与 URL;brief 用于标准研究问题,输出带建议的综合简报;breadth 用于梳理领域、调研选项,输出包含分类、关键参与者和空白的全景图;deep 用于决策关键、需要验证的场景,输出带置信度和已验证来源的完整报告。若用户未指定深度,可按查询推断或询问。
使用方式:流程严格顺序执行。Step 0 检查已有知识(scan 跳过),查看本地文件以跳过已覆盖维度。Step 1 规划,用宿主子代理工具派发 planner,否则内联规划,并在派发搜索前向用户展示计划。Step 2 搜索,先创建运行目录 ~/.local/state/web-research/{timestamp}-{query-slug}/,确认可写后保存 plan.md;若失败则回退到宿主会话临时目录或项目内 .web-research/ 目录,并告知用户。并行派发所有搜索代理,每个写入 {run-dir}/{dimension}.md 并只返回路径;等待全部完成后检查文件是否存在且非空,失败维度重派一次,再失败则丢弃并记录缺口。Step 3 交叉补充仅 deep 模式。Step 4 综合,scan 跳过。Step 5 验证仅 deep 模式,由独立验证代理检查引用 URL。
适用场景:快速事实核查、标准研究、领域调研、决策级深度报告。
限制:运行目录为 POSIX 路径,无头或 SDK 运行可能拒绝项目外写入;搜索代理只返回文件路径而非完整页面内容;综合代理继承用户模型,不得覆盖;缺失或空文件会导致综合报输入错误,应视为流程失败修复而非直接呈现。模型与努力层级、宿主映射等细节见技能内 references/ 文件。