SuperAPI AI 工具集

search-web

通用与其它

查看项目

更新于 10-16 10:18

技能介绍

用途

search-web 是一套用于系统性多轮网络研究的技能。它的目标是在正式搜索前先澄清研究需求,再通过多轮、多代理并行搜索与质量评估,产出经过验证的研究结果。资料称其采用 Evaluator-optimizer 模式,并基于 YC Office Hours 的提问方法论。

主要能力

  • 三层 Ask 框架:研究目标分类 → 模式专用提问 → 输出 YAML 研究需求文档。
  • 智能跳过规则:根据用户原始输入自动跳过已回答的问题(例如用户说"快速了解一下"则默认扫描模式)。
  • Escape hatch 快速模式:当用户不耐烦时提供可控降级选项。
  • 研究模式分类:聚焦(Focused)、扫描(Scan)、全面(Comprehensive)三种模式对应不同策略。
  • 评估器-优化器循环:以质量驱动迭代搜索。
  • 评估维度包含覆盖度、来源质量、一致性、具体性、时效性,每项 1-5 分。

使用方式(工作流程)

  1. 需求澄清:项目重述、研究目标分类、模式专用提问、逃生舱口、输出研究需求文档(YAML)。
  2. 评估任务与查询构建:确定搜索模式(easy/medium/hard)、选择初始方向、创建搜索任务(todos)、构建查询集群。
  3. 分发子代理搜索(并行):创建搜索团队(TeamCreate),启动 2~4 个并行 Agent,子代理将结果写入独立文件 turn-{n}/search-agent-{n}-task.md。
  4. 聚合结果到结构化日志:初始化会话目录 /tmp/search-web/{date}/{task}/,创建协调日志 master-log.md,父代理记录事件时间线。
  5. 评估器-优化器循环:启动评估器读取各子代理文件,输出报告 turn-{n}/search-evaluator-turn-{n}.md;决策点判定:全部维度 5/5 则 COMPLETE,否则 CONTINUE;再启动优化器生成 turn-{n}/query-optimizer-turn-{n}.md。
  6. 交付经过验证的结果:生成最终报告 report.md,向用户展示主日志位置,用户审核与反馈;若用户拥有 /save-ob-chaos 技能,则执行并存档报告文件。

查询构建使用的技巧包括:并排比较、时间限制、公开基准、特定站点(GitHub issues、HN、StackOverflow 等)、学术报告(论文、arXiv、研究博客)、多角度(负面 Bug、限制、投诉)、多语种搜索等。

会话目录结构示例:

/tmp/search-web/2026-04-05/powershell-bash-research/
├── task.yaml
├── master-log.md
├── report.md
├── turn-1/
│   ├── search-agent-1-task.md
│   ├── search-agent-2-task.md
│   └── search-evaluator-turn-1.md
├── turn-2/
│   ├── search-agent-3-task.md
│   ├── search-agent-4-task.md
│   ├── search-evaluator-turn-2.md
│   └── query-optimizer-turn-2.md
└── turn-3/
    ├── search-agent-5-task.md
    ├── search-agent-6-task.md
    └── search-evaluator-turn-3.md

评估器退出条件(硬性标准):覆盖度、来源质量、一致性、具体性、时效性均需达到 5/5,任一维度 ≤4 必须继续搜索。停止条件包括:所有维度评分 = 5/5、达到轮次限制(默认 4 轮)、用户强制停止。

适用场景

  • 验证假设:已有具体想法,需要找到支持/反对的证据,对应聚焦模式。
  • 对比决策:在几个选项之间做选择(技术选型、方案对比等),对应聚焦模式。
  • 探索未知:对某领域不了解,需要系统性概览,对应扫描模式。
  • 追踪最新:了解某领域的最新进展、版本、趋势,对应扫描模式。
  • 深度调查:全面收集信息,形成完整认知,对应全面模式。

限制

资料中明确的限制与规则包括:

  • 评估器为必需环节,不应跳过质量评估。
  • 采用硬性退出标准,所有维度必须达到 5/5,不允许以"综合判断"绕过。
  • 搜索代理遇到 429 Rate Limit 错误时应立即停止搜索,返回已获取的部分结果与错误说明,不无限重试或切换工具继续搜索。
  • 默认最大轮次为 4 轮。

资料未提供安装命令、收费与价格、支持平台、具体性能效果等信息,这些内容暂未提供。