wiki-synthesize

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Wiki Synthesize — First-Class Synthesis Discovery

Wiki Synthesize — 一流的合成发现

You are scanning the wiki for concepts that co-occur across many pages but have no dedicated synthesis page connecting them. Your job is to surface these gaps and fill the most valuable ones with cross-cutting synthesis pages.

你需要扫描wiki，找出在多个页面中共同出现但没有专门合成页面连接的概念。你的任务是找出这些空白，并为最有价值的空白创建跨领域的合成页面。

Before You Start

开始之前

Read

~/.obsidian-wiki/config

(preferred) or

.env

(fallback) to get

OBSIDIAN_VAULT_PATH

Read
```
index.md
```
to get the full page inventory.
Read
```
hot.md
```
if it exists — it surfaces recent activity and active threads that may already point to synthesis opportunities.
Read
```
_meta/taxonomy.md
```
to understand the tag vocabulary.

读取

~/.obsidian-wiki/config

（优先）或

.env

（备选）以获取

OBSIDIAN_VAULT_PATH

。

读取
```
index.md
```
以获取完整的页面清单。
如果存在
```
hot.md
```
，请读取它——它会展示近期活动和活跃讨论线索，这些可能已经指向合成机会。
读取
```
_meta/taxonomy.md
```
以理解标签词汇体系。

Step 1: Build the Co-occurrence Map

步骤1：构建共现映射

Scan every non-special page in the vault (skip

index.md

log.md

hot.md

_insights.md

_meta/*

_archives/*

_raw/*

For each page, collect:

All
```
[[wikilinks]]
```
it contains (outgoing links)
Its
```
tags
```
frontmatter
Its
```
category
```
frontmatter

Build a co-occurrence matrix: for every pair of concept/entity pages (A, B), count how many other pages link to both A and B. This is their co-occurrence score.

You don't need to be exhaustive — aim for the top 20-30 pairs by co-occurrence score. Use Grep to find backlinks efficiently:

bash

grep -rl "\[\[ConceptA\]\]" "$OBSIDIAN_VAULT_PATH" --include="*.md"

Run this for your top candidate concepts and intersect the result sets.

扫描vault中所有非特殊页面（跳过

index.md

、

log.md

、

hot.md

、

_insights.md

、

_meta/*

、

_archives/*

、

_raw/*

）。

对于每个页面，收集：

它包含的所有
```
[[wikilinks]]
```
（出站链接）
它的
```
tags
```
前置元数据
它的
```
category
```
前置元数据

构建共现矩阵：对于每一对概念/实体页面（A, B），统计有多少其他页面同时链接到A和B。这就是它们的共现得分。

你不需要做到穷尽——目标是共现得分排名前20-30的概念对。使用Grep高效查找反向链接：

bash

grep -rl "\[\[ConceptA\]\]" "$OBSIDIAN_VAULT_PATH" --include="*.md"

为你的候选核心概念运行此命令，并取结果集的交集。

Step 2: Filter Out Already-Synthesized Pairs

步骤2：过滤已合成的概念对

Check the

synthesis/

directory for existing pages. For each existing synthesis page:

Read its
```
sources
```
frontmatter or its body for
```
[[wikilinks]]
```
Mark those concept pairs as already covered

Remove covered pairs from your candidate list.

检查

synthesis/

目录中的现有页面。对于每个现有合成页面：

读取其
```
sources
```
前置元数据或正文中的
```
[[wikilinks]]
```
将这些概念对标记为已覆盖

从候选列表中移除已覆盖的概念对。

Step 3: Score and Rank Candidates

步骤3：为候选者评分并排序

For each remaining candidate pair (or cluster of 3+), assign a synthesis value score:

Signal	Points
Co-occurrence count ≥ 5	+3
Co-occurrence count 3-4	+2
Co-occurrence count 1-2	+1
Concepts are in different categories (cross-domain)	+2
Concepts share tags but live in different folders	+1
One or both concepts are tagged as hubs in `_insights.md`	+1
A synthesis would resolve a flagged contradiction	+2

Pick the top 5 candidates. If the user asked for a specific topic ("synthesize everything about observability"), filter candidates to that domain first.

对于每个剩余的候选概念对（或3个及以上的概念组），分配合成价值得分：

信号	分值
共现次数 ≥5	+3
共现次数 3-4	+2
共现次数 1-2	+1
概念属于不同分类（跨领域）	+2
概念共享标签但位于不同文件夹	+1
一个或多个概念在 `_insights.md` 中被标记为枢纽	+1
合成可解决已标记的矛盾	+2

选择排名前5的候选者。如果用户要求特定主题（例如“synthesize everything about observability”），请先将候选者过滤到该领域。

Step 4: Draft Synthesis Pages

步骤4：草拟合成页面

For each top candidate, create a page in

synthesis/

using this template:

markdown

---
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
---

对于每个顶级候选者，使用以下模板在

synthesis/

目录中创建页面：

markdown

---
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
---

<Concept A> × <Concept B>

The Connection

关联关系

What makes these two concepts worth synthesizing together — the non-obvious relationship that pages about each individually don't capture.

是什么让这两个概念值得合成——单个概念页面未提及的非显而易见的关系。

Where They Co-occur

共现场景

The pages and contexts where both appear. What situations bring them together.

两个概念同时出现的页面和场景。什么情况下会将它们联系在一起。

Cross-cutting Insight

跨领域洞察

The conclusion that only becomes visible when you look at both together. This is the point of the page — the thing you couldn't see from either concept page alone.

只有同时审视两个概念才能发现的结论。这是本页面的核心价值——从单个概念页面无法看到的内容。

Tensions and Trade-offs

张力与权衡

Where the two concepts pull in opposite directions. Unresolved contradictions. Cases where applying one undermines the other.

两个概念方向相反的情况。未解决的矛盾。应用其中一个会削弱另一个的场景。

Open Questions

开放问题

What this synthesis surfaces that the wiki doesn't yet have an answer for. Good candidates for future research.

本次合成揭示的wiki尚未给出答案的内容。这些是未来研究的优质候选方向。

Step 5: Back-link from Source Pages

步骤5：从源页面添加反向链接

For each synthesis page you created, add a link to it from the two (or more) concept pages it synthesizes. In the concept page, add to its

## Related

section:

markdown

- [[Concept A × Concept B]] — synthesis

If the concept page has no

## Related

section, add one at the bottom.

对于你创建的每个合成页面，从它所合成的两个（或多个）概念页面添加指向它的链接。在概念页面的

## 相关链接

部分添加：

markdown

- [[Concept A × Concept B]] — 合成页面

如果概念页面没有

## 相关链接

部分，请在页面底部添加该部分。

Step 6: Report Synthesis Opportunities Not Taken

步骤6：报告未处理的合成机会

After creating pages for the top 5, list the next 10 candidates in your output — pairs that scored well but you didn't write pages for. This gives the user visibility into what the wiki thinks is worth exploring without forcing every synthesis in one run.

Format:

Skipped (consider next time):
- [[Caching]] × [[Consistency]] — co-occurs in 4 pages, cross-domain
- [[Testing]] × [[Observability]] — co-occurs in 3 pages, shares tags
...

在为前5个候选者创建页面后，在输出中列出接下来的10个候选者——得分较高但未编写页面的概念对。这能让用户了解wiki认为值得探索的内容，而无需一次性完成所有合成。

格式：

已跳过（下次可考虑）：
- [[Caching]] × [[Consistency]] — 在4个页面中共现，跨领域
- [[Testing]] × [[Observability]] — 在3个页面中共现，共享标签
...

Step 7: Update Special Files

步骤7：更新特殊文件

index.md
— Add entries for all new synthesis pages.

log.md
— Append:

- [TIMESTAMP] WIKI_SYNTHESIZE pages_scanned=N synthesis_created=M candidates_skipped=K

hot.md
— Read

$OBSIDIAN_VAULT_PATH/hot.md

(create from the template in

wiki-ingest

if missing). Update Recent Activity with what was synthesized — e.g. "Synthesized 5 cross-cutting pages: Caching × Consistency, Testing × Observability, …". Update Active Threads with any open questions the synthesis surfaced. Update

updated

timestamp.

index.md
— 为所有新合成页面添加条目。

log.md
— 追加内容：

- [TIMESTAMP] WIKI_SYNTHESIZE pages_scanned=N synthesis_created=M candidates_skipped=K

hot.md
— 读取

$OBSIDIAN_VAULT_PATH/hot.md

（如果缺失，使用

wiki-ingest

中的模板创建）。更新近期活动部分，注明已合成的内容——例如“合成了5个跨领域页面：Caching × Consistency、Testing × Observability……”。更新活跃讨论线索部分，添加本次合成揭示的开放问题。更新

updated

时间戳。

Quality Checklist

质量检查清单

Every synthesis page has a
```
summary:
```
field (≤200 chars)
Every synthesis page links back to its source concepts
Source concept pages link forward to the synthesis page
No synthesis page just restates what's already on the source pages — it must add a cross-cutting insight
```
index.md
```
and
```
log.md
```
updated
```
hot.md
```
updated

每个合成页面都有
```
summary:
```
字段（≤200字符）
每个合成页面都反向链接到其源概念
源概念页面都正向链接到合成页面
合成页面不只是重述源页面已有的内容——必须添加跨领域洞察
```
index.md
```
和
```
log.md
```
已更新
```
hot.md
```
已更新

Tips

提示

A synthesis page that only summarizes its sources is useless. The value is the connection — the thing neither source page says explicitly.
Don't synthesize for synthesis's sake. If two concepts just happen to appear together a lot without a real conceptual link, skip them.
Three-way syntheses are powerful but rare. Only create them when three concepts form a genuine triangle of mutual influence — not just because all three appear in the same project page.
Check
_insights.md
first. The wiki-status skill may have already flagged synthesis candidates there — start with those before running the co-occurrence scan from scratch.

仅总结源内容的合成页面毫无用处。 价值在于关联——单个源页面未明确提及的内容。
不要为了合成而合成。 如果两个概念只是偶然频繁共同出现，但没有真正的概念关联，请跳过它们。
三方合成功能强大但罕见。 只有当三个概念形成真正的相互影响三角关系时才创建三方合成页面——不能仅仅因为它们都出现在同一个项目页面中。
先检查
_insights.md
。 wiki-status技能可能已经在其中标记了合成候选者——先从这些候选者开始，再从头运行共现扫描。