SuperAPI AI 工具集

wiki-research

写作与研究

查看项目

更新于 10-16 07:47

技能介绍

用途

wiki-research 用于对一个主题执行自主的多轮网络研究,综合研究发现,并将结构化结果作为永久知识归档到 Obsidian 知识库中。它适合需要系统化、可追溯地积累网络来源知识的场景。

主要能力

  • 多轮研究循环:第一轮进行广泛调研,将主题拆解为 3-5 个不同角度,每个角度运行 2-3 条 WebSearch 查询,并对每个角度的前 2-3 条结果使用 WebFetch(或 defuddle)获取内容。
  • 信息抽取:从每个抓取页面中抽取关键主张(Key claims)、概念(Concepts)、实体(Entities)和矛盾点(Contradictions)。
  • 缺口填补:第二轮针对第一轮遗留的问题、矛盾点和覆盖薄弱的角度,运行最多 5 条定向搜索,优先使用一手来源、官方文档和权威分析。
  • 综合校验:第三轮解决矛盾、确认深度是否足够;若矛盾无法解决则在综合页面中明确标注。停止条件为达到足够深度或完成 3 轮。
  • 结构化归档:将发现组织为四类输出区域:sources/(每个主要参考一页)、concepts/(每个实质概念一页)、entities/(工具、组织、人物)、synthesis/Research: [Topic].md(主综合页面)。
  • 交叉链接:每个概念页至少链接到 2 个来源页;每个来源页链接到其影响的概念页;综合页链接到所有生成的概念、实体和来源页。
  • 跟踪文件更新:更新 .manifest.json,并通过 obsidian-wiki memory sync 命令更新索引、日志和热缓存。
  • 可选研究后端:支持在 references/research-backends.md 中注册 CLI 检索后端(如 defuddle、yt-dlp、perplexity),并在研究过程中按 when_to_use 匹配调用。

使用方式

  1. 开始前准备:阅读并应用 llm-wiki/SKILL.md 中的 Writing Profile Resolution 部分;遵循 Config Resolution Protocol 解析配置,获得 OBSIDIAN_VAULT_PATH 和 OBSIDIAN_LINK_FORMAT(默认 wikilink)。
  2. 读取知识库现状:读取 $OBSIDIAN_VAULT_PATH/index.md 了解已有内容,避免重复研究;读取 hot.md(若存在)获取近期上下文;检查 references/research-config.md 和 references/research-backends.md(若存在)。
  3. 确认主题:若研究主题不明确,先与用户确认。
  4. 执行三轮研究:按上述第一、二、三轮流程进行。
  5. 归档页面:按四类输出区域写入页面,使用规定的 frontmatter 格式。
  6. 交叉链接与去重:检查 index.md 中是否有同主题页面,合并而非重复创建。
  7. 更新跟踪文件:向 .manifest.json 添加研究条目,并运行 obsidian-wiki memory sync 命令。不要手动编辑 index.md、log.md 或 hot.md。
  8. QMD 刷新(可选):若 $QMD_WIKI_COLLECTION 已设置,在写入或重写知识库 Markdown 后运行 QMD 更新与嵌入,并验证集合。

适用场景

  • 需要对某一主题进行系统化网络调研并沉淀为 Obsidian 永久知识。
  • 需要多来源综合、矛盾点标注和可追溯引用的研究任务。
  • 需要利用可选 CLI 后端(如视频转录、付费搜索 API)增强检索能力的研究。

限制

  • 研究轮次上限为 3 轮,不会无限循环。
  • 可选后端若二进制不可用或付费后端环境变量未设置,会被标记为不可用并跳过;后端失败不会中止研究,始终回退到 WebSearch/WebFetch。
  • QMD 是搜索索引而非事实来源;QMD 刷新失败不会回滚知识库更改,需单独报告状态。
  • 具体收费、价格、平台支持范围等细节暂未提供。