SuperAPI AI 工具集

research

写作与研究

查看项目

更新于 10-15 17:07

技能介绍

用途

Research 技能用于诊断研究质量并引导系统性的查询扩展。它适合在开始研究任何主题、研究过程中卡住,或不确定研究是否足够时使用。其目标是通过工具辅助研究与 Tavily 集成,把基础问题转化为更全面的搜索策略,借助 AI 优化的网络搜索来提升研究深度和覆盖面。

主要能力

该技能围绕研究流程的多个阶段组织工作,并配合 Tavily 命令行搜索工具完成查询。

阶段划分:

  • 阶段 0(手动):分析主题、设定范围与决策风险等级。
  • 阶段 1(Tavily):发现专家术语。
  • 阶段 2(Tavily):基础搜索。
  • 阶段 3(Tavily):反方视角搜索。
  • 阶段 4(手动):综合发现并标注置信度。

范围与 Tavily 深度对应:

  • 低风险、可逆:--depth basic --results 3
  • 中等:--depth basic --results 5 --answer
  • 高风险、不可逆:--depth advanced --results 10 --answer

阶段 0 提供分析模板,涵盖核心概念(主要术语、术语变体、歧义术语)、利益相关者(主要参与者、受影响群体、对立利益)、时间范围(历史起源、关键转变、当前状态)、领域(主要领域、相邻领域)以及争议(活跃辩论、竞争框架)。

阶段 1 强调发现专家术语的重要性,并提供发现词汇的 Tavily 命令示例,以及词汇映射表模板。

阶段 2 提供问题模式到 Tavily 命令的映射,例如“What is X?”对应定义类查询,“Should I X?”对应利弊比较,“Is X true?”对应证据与反证,并给出源类型选择建议(学术/研究、从业者内容、新闻/当前、官方文档)。

阶段 3 强调主动查找反对观点,避免确认偏误,并提供通用批评、对立观点、替代方法、失败案例以及排除熟悉来源等命令示例。

阶段 4 提供完成标准(最低可行、工作知识、深度专业知识)、边际收益递减信号、置信度标记与综合模板,模板包含摘要、置信水平、关键发现、视角对照、反证、注意事项和进一步调查方向。

技能还提供诊断状态,用于识别研究卡在哪里以及应回到哪个阶段:

  • R0:无分析
  • R1:无词汇
  • R2:单一视角
  • R3:领域盲区
  • R4:近期偏见
  • R5:有广度无深度
  • R6:完成不确定性
  • R7:完成

以及反模式表,列出确认陷阱、权威谬误、近期陷阱、广度陷阱、单一来源、术语盲点、无限兔子洞和回音室,并给出对应修正建议。

使用方式

设置要求:

  • Deno,可从 https://deno.land 安装。
  • Tavily API Key,可在 https://tavily.com 获取(官方称有免费额度)。

配置 API Key:

export TAVILY_API_KEY="your-key-here"

为方便使用,可在 shell 配置文件中创建别名(需按技能安装路径调整):

alias tavily='deno run --allow-net --allow-env /path/to/skills/research/scripts/tavily-cli.ts'

也可直接运行:

deno run --allow-net --allow-env ./scripts/tavily-cli.ts "your query"

以下是常用命令示例:

基础搜索

tavily "your query"

附带 AI 答案摘要

tavily "your query" --answer

深度搜索,更多结果

tavily "your query" --depth advanced --results 10 --answer

新闻/近期内容

tavily "your query" --topic news --time week

排除熟悉来源以发现新视角

tavily "your query" --exclude wikipedia.org,reddit.com

Tavily 命令选项包括:

  • --answer:包含 AI 生成的答案摘要。
  • --depth:搜索深度,basic(默认)或 advanced。
  • --results:结果数量,1-20(默认 5)。
  • --topic:主题类别,general(默认)、news 或 finance。
  • --time:时间过滤,day、week、month、year。
  • --include:仅包含指定域名,逗号分隔。
  • --exclude:排除指定域名,逗号分隔。
  • --raw:包含原始页面内容。
  • --json:以 JSON 格式输出。

输出持久化方面,技能建议先检查项目中的 context/output-config.md,若找到本技能条目则按其配置,否则先询问用户保存位置,并建议 explorations/research/ 或其他合适位置。需要存储的内容包括词汇映射、来源(URL、相关度评分、质量说明)、综合结论(摘要、置信度、发现、注意事项)、查询日志和未知缺口。文件命名模式为 {topic}-research-{date}.md,例如 competency-frameworks-research-2025-01-15.md。

技能还提到与其他技能的集成点:doppelganger(研究为决策提供信息,对发现应用 /truth-check)、context-networks(将研究发现存入合适的网络节点)、boundary-critique(对遇到的建议和推荐应用)。

适用场景

  • 开始研究任何主题时,用于结构化主题并设定范围。
  • 研究过程卡住时,用于诊断卡点并确定应回到哪个阶段。
  • 不确定研究是否足够时,用于对照完成标准和边际收益递减信号做判断。
  • 需要避免单一视角和确认偏误时,用于显式搜索反方观点。
  • 需要发现专家术语、跨领域同义词以解锁更深搜索结果时。

限制

该技能依赖 Deno 运行环境和 Tavily API Key,缺少其中任一条件可能无法使用其 Tavily 命令行搜索功能。技能资料中未提供 Tavily 的收费、价格或免费额度期限等具体商业条款,也未提供除上述命令选项之外的其他功能、平台支持或效果保证。资料中未涉及的具体使用步骤或额外能力,暂未提供。