SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-17 01:27

技能介绍

Research 是一个面向多来源并行研究的技能,通过 Bash 调用 Research CLI 完成检索。文档明确要求:对于任何研究请求,应使用该 CLI,而不是直接使用 WebSearch。

主要能力与来源

支持三种数据来源,可单独调用,也可用 --all 一次性并行调用全部来源:

  • --perplexity:快速网络搜索,需要 PERPLEXITY_API_KEY
  • --gemini:提供多视角分析,需要 GOOGLE_API_KEY
  • --claude:详细分析(速度较慢),使用内置 WebSearch,无需额外密钥

密钥配置位于 ~/.claude/.env。

三种研究模式

  • 快速模式:触发词为“quick research”或简单查询;执行单次 research --all 调用;耗时约 15-30 秒;返回 3 个来源结果。
  • 标准模式(默认):适用于大多数研究请求;通过 3 个并行 Bash 调用从不同查询角度检索;耗时约 30-45 秒;返回 9 个来源结果(3 个角度 × 3 个来源)。
  • 深度模式:触发词为“extensive research”或“deep dive”;执行 8 个并行 Bash 调用,覆盖多样角度;耗时约 45-90 秒;返回 24 个来源结果(8 个角度 × 3 个来源)。

使用方式

标准流程:第一步,将问题拆解为三个子问题,分别聚焦核心事实与最新进展、背景与影响分析、反方观点或争议与边缘案例;第二步,在单条消息中并行发起 3 个 Bash 调用(这是关键,应避免顺序执行);第三步,解析每个调用返回的 JSON,字段包括 source、query、timestamp、success、content、citations、duration_ms,--all 返回三个结果的数组;第四步,按置信度综合结果:两个以上来源相互印证为高置信度,单一来源但看似可靠为中置信度,单一来源且需验证为低置信度,并在报告中按主题、来源归因、冲突信息分节整理。

深度模式还会额外覆盖历史背景与演进、技术深入剖析、实际应用、反方与批评、未来预测、跨领域关联、边缘案例等角度。

错误处理与报告

若某个来源失败,则继续使用成功的结果,并在最终报告中注明失败情况,可通过 JSON 中的 success: false 判断。文档建议在每份研究报告末尾附上研究指标模板,包含模式、总查询数、来源和置信度等级。

适用场景与限制

适用于需要多来源交叉验证、时效性检索或深入分析的研究任务;限制包括依赖外部 CLI 路径(~/.claude/bin/research)和 Perplexity、Gemini 的 API 密钥,缺少密钥时对应来源不可用;并行调用需在同一消息内发起,否则会失去速度优势。