SuperAPI AI 工具集

wiki-synthesize

写作与研究

查看项目

更新于 10-16 07:47

技能介绍

用途

wiki-synthesize 用于扫描 Obsidian 知识库(wiki),找出那些在许多页面中反复共同出现、却没有专门综合页面把它们连接起来的概念。它的目标是发现这些空白,并为其中最有价值的组合创建跨领域的综合页面。

主要能力

  • 构建共现地图:扫描知识库中每个非特殊页面,收集其出链([[wikilinks]])、标签 frontmatter 和分类 frontmatter,统计每对概念/实体页面被多少其他页面同时链接,形成共现分数。
  • 过滤已综合的组合:检查 synthesis/ 目录中已有页面,读取其 sources frontmatter 或正文中的链接,将已覆盖的概念对从候选中移除。
  • 评分与排序:根据共现次数、是否跨领域、是否共享标签但位于不同文件夹、是否为枢纽概念、是否能解决已标记的矛盾等信号打分,选出前 5 个候选。
  • 起草综合页面:按模板在 synthesis/ 目录创建页面,包含标题(A × B 格式)、来源、摘要、provenance、置信度、生命周期等字段,以及“连接点”“共现位置”“跨领域洞察”“张力与权衡”“最强反驳”“开放问题”“相关”等章节。
  • 回链源页面:在综合页所综合的概念页面的 ## Related 章节中添加指向综合页的链接。
  • 报告未采用的综合机会:列出评分较高但未创建页面的后续 10 个候选。
  • 更新特殊文件:通过一条命令同步更新 index、log 和 hot 缓存,并将综合页产生的开放问题记录为待办。

使用方式

该技能以自然语言指令形式运行,通常由 AI 代理执行。开始前需解析配置(OBSIDIAN_VAULT_PATH 和 OBSIDIAN_LINK_FORMAT),读取 index.md、hot.md、_meta/taxonomy.md 等文件。随后按步骤执行:构建共现地图、过滤已综合组合、评分排序、起草综合页、回链源页面、报告未采用机会、更新特殊文件。写入知识库后,若设置了 QMD 相关环境变量,还需刷新 QMD 搜索索引。

适用场景

  • 知识库中多个主题反复交叉出现,但缺少把它们联系起来的页面。
  • 需要挖掘跨领域洞察,发现单个概念页无法呈现的联系。
  • 用户指定特定主题(如“综合所有关于可观测性的内容”)时,可先按该领域过滤候选。

限制

  • 综合页必须增加跨领域洞察,不能只是复述源页面内容。
  • 不应为了综合而综合;若两个概念只是偶然一起出现而无真实概念联系,应跳过。
  • 三方综合虽然强大但罕见,仅当三个概念形成真正的相互影响三角时才创建。
  • 综合页大多标记为 ^[inferred],来源分歧处标记为 ^[ambiguous]。
  • 每个综合页必须写明“最强反驳”并附可测试的搜索查询,不得编造引用。
  • 不得手动编辑 index.md、log.md 或 hot.md,必须通过命令加锁更新。
  • QMD 刷新失败时不应回滚知识库更改,需单独报告 QMD 状态。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。