在 Obsidian wiki…

当 Obsidian wiki 增长后，需要扫描高频共现但无综合页的概念对/簇，并创建带跨领域结论的综合页时使用。

适用场景

解决思路

1. 开始前：在起草或重写自然语言 Markdown 前，阅读并应用 `llm-wiki/SKILL.md` 中的 `Writing Profile Resolution` 节；框架 schema、provenance、安全、操作特定要求优先；`WRITING.md` 偏好仅适用于新起草或重写的自然语言 Markdown，保留源内容与结构化记录。
2. 解析配置：遵循 `llm-wiki/SKILL.md` 中的 Config Resolution Protocol（内联 `@name` 覆盖 → 从 CWD 向上查找 `.env` → 全局配置 → 提示设置），取得 `OBSIDIAN_VAULT_PATH` 和 `OBSIDIAN_LINK_FORMAT`（默认 `wikilink`）。
3. 读取 `index.md`，获取完整页面清单。
4. 如果 `hot.md` 存在则读取它；它会暴露最近活动和活跃线程，可能已指向综合机会。
5. 读取 `_meta/taxonomy.md`，理解标签词表。
6. 在综合页写内部链接时，根据 `OBSIDIAN_LINK_FORMAT` 值，应用 `llm-wiki/SKILL.md` 的 Link Format 节中的链接格式。
7. Step 1：扫描 vault 中每个非特殊页面，跳过 `index.md`、`log.md`、`hot.md`、`_insights.md`、`_meta/*`、`_archives/*`、`_raw/*`。
8. 对每个页面收集：所有 `[[wikilinks]]`（出链）、`tags` frontmatter、`category` frontmatter。
9. 构建共现矩阵：对每一对概念/实体页 (A, B)，统计有多少其他页面同时链接到 A 和 B；这个数量就是它们的共现分数。
10. 不必穷尽，目标按共现分数取 top 20-30 对；用 Grep 高效查找反向链接：`rg -l --glob '*.md' "\[\[ConceptA\]\]" "$OBSIDIAN_VAULT_PATH"`，对 top 候选概念运行并取结果集交集。
11. Step 2：检查 `synthesis/` 目录已有页面；对每个已有综合页，读取其 `sources` frontmatter 或正文中的 `[[wikilinks]]`，标记这些概念对已被覆盖。
12. 从候选列表中移除已覆盖的概念对。
13. Step 3：对剩余候选对（或 3+ 簇）分配综合价值分：共现次数 ≥5 得 +3；共现次数 3-4 得 +2；共现次数 1-2 得 +1；概念属于不同 category（跨领域）得 +2；概念共享 tags 但位于不同文件夹得 +1；一个或两个概念在 `_insights.md` 中被标记为 hubs 得 +1；综合能解决已标记矛盾得 +2。
14. 选取 top 5 候选；如果用户指定主题（如 `synthesize everything about observability`），先按该领域过滤候选。
15. Step 4：对每个 top 候选，在 `synthesis/` 中用模板创建页面；frontmatter 包含 `title: <Concept A> × <Concept B>`、`category: synthesis`、`tags: [<shared tags>, <domain tags>]`、`sources: [<all pages that link to both>]`、`created: TIMESTAMP`、`updated: TIMESTAMP`、`summary: "Cross-cutting synthesis of how <A> and <B> interact, with implications for <domain>."`、`provenance: extracted: 0.2, inferred: 0.7, ambiguous: 0.1`、`base_confidence: <min(base_confidence of all input pages)>`、`lifecycle: draft`、`lifecycle_changed: TIMESTAMP_DATE`。
16. 页面正文结构：`# <Concept A> × <Concept B>`，`## The Connection`（为什么值得一起综合——单页没有捕捉到的非显然关系），`## Where They Co-occur`（两者共同出现的页面和上下文），`## Cross-cutting Insight`（只有一起看才可见的结论，页面核心），`## Tensions and Trade-offs`（概念相互拉扯、未解决矛盾、应用一个会削弱另一个的情况），`## Strongest Objection`（对本文跨领域洞见的最佳怀疑解读，然后给可测试搜索查询，如 `> test: does X actually hold when Y is controlled for?`，绝不要编造引用；不能命名最强反对意见的综合没资格下结论），`## Open Questions`，`## Related` 链接 `[[<Concept A>]]`、`[[<Concept B>]]`、`[[<other related pages>]]`。
17. 综合页主要标为 `^[inferred]`；跨领域结论用 `^[inferred]`，来源矛盾处用 `^[ambiguous]`。
18. 标题格式为 `A × B`，向读者表示这是综合页，而不是任一单独概念的页面。
19. Step 5：对每个新建综合页，从它综合的两个（或更多）概念页添加回链；在概念页的 `## Related` 节添加：`- [[Concept A × Concept B]] — synthesis`。如果概念页没有 `## Related` 节，在底部添加一个。
20. Step 6：创建 top 5 页面后，在输出中列出接下来 10 个候选——评分高但未写页的概念对；格式为 `Skipped (consider next time):`，例如 `- [[Caching]] × [[Consistency]] — co-occurs in 4 pages, cross-domain`、`- [[Testing]] × [[Observability]] — co-occurs in 3 pages, shares tags`。
21. Step 7：更新 `index.md`，为所有新综合页添加条目。
22. 更新 `log.md`，追加：`- [TIMESTAMP] WIKI_SYNTHESIZE pages_scanned=N synthesis_created=M candidates_skipped=K`。
23. 更新 `hot.md`：读取 `$OBSIDIAN_VAULT_PATH/hot.md`（如缺失，按 `wiki-ingest` 中的模板创建）；用综合内容更新 **Recent Activity**，例如 `Synthesized 5 cross-cutting pages: Caching × Consistency, Testing × Observability, …`；用综合暴露的开放问题更新 **Active Threads**；更新 `updated` 时间戳。
24. 质量检查：每个综合页有 `summary:` 字段（≤200 chars）；每个综合页链接回源概念；源概念页前向链接到综合页；没有综合页只是复述源页面，必须添加跨领域洞见；每个综合页命名 Strongest Objection 并带可测试搜索查询（不是编造来源）；`index.md` 和 `log.md` 已更新；`hot.md` 已更新。
25. Tips：只总结来源的综合页无用；价值在连接，即两个源页面都没明说的东西。
26. Tips：不要为综合而综合；如果两个概念只是碰巧一起出现很多但没有真实概念联系，跳过。
27. Tips：三向综合强大但罕见；仅当三个概念形成真正互相影响的三角时才创建，而不是因为三者出现在同一项目页。
28. Tips：先检查 `_insights.md`；wiki-status skill 可能已标记综合候选，先从这些开始，再从头运行共现扫描。
29. QMD Refresh After Vault Writes：QMD 是搜索索引，不是事实源；如果 `$QMD_WIKI_COLLECTION` 为空或未设置，跳过此步；仅在本 skill 写入或重写 vault markdown 后运行；如果 QMD refresh 失败，不回滚 vault 更改，单独报告 QMD 状态。
30. QMD 刷新：如果设置了 `$QMD_CLI` 就用它，否则用 `qmd`；运行 `${QMD_CLI:-qmd} update`。
31. 如果输出说需要 vectors 或 embeddings 可能 stale，运行 `${QMD_CLI:-qmd} embed`。
32. 用以下之一验证 collection：`${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"`；或已知具体页面路径时：`${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5`。
33. 记录以下之一：`QMD refreshed: update + embed + verified`；`QMD refreshed: update only + verified`；`QMD skipped: QMD_WIKI_COLLECTION unset`；`QMD skipped: qmd CLI unavailable`；`QMD failed: <short error summary>`。

适用边界 · 注意事项

• 没有 Obsidian vault 或不符合 `llm-wiki` 目录/配置时不要使用；缺少 `OBSIDIAN_VAULT_PATH`、`index.md`、`synthesis/` 等无法执行。
• 两个概念只是高频共现但没有真实概念联系时不要强行创建综合页；不要为综合而综合。
• `$QMD_WIKI_COLLECTION` 为空/未设置或 `qmd` CLI 不可用时，跳过 QMD 刷新；QMD 刷新失败不回滚 vault。