feat: wiki 連結升級成 typed-edge 三元組 A >> 謂詞 >> B(issue #5)

裸 [[wikilink]] 是弱連結——只說「有關」,沒說關係是什麼,下游要建
knowledge graph 還得回讀兩張卡。改寫成帶語義的三元組,下游 ingest 直接
parse 出帶類型的有向邊,把關係也預編譯。

- wiki-init.md + docs/SKILL.md 的 ## 關聯 改用 [[A]] >> 謂詞 >> [[B]]。
- 規則:方向性、謂詞用動詞、自由詞彙、向後相容(裸 [[A]] 仍合法)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-25 23:11:31 +08:00
parent 6b49f35925
commit 331e4d56a7
4 changed files with 36 additions and 6 deletions
+11
View File
@@ -10,6 +10,17 @@
---
## 1.5.0 — wiki 連結升級成 typed-edge 三元組(issue #5
**背景**`## 關聯` 原本只列裸 `[[頁面]]`(沿用 Karpathy LLM Wiki)。但裸 `[[A]]` 是**弱連結**——只說「A 和本卡有關」,沒說關係是什麼。下游要從 wiki 抽 knowledge graph 時,拿到一堆無類型 edges,仍得回讀兩張卡才知道關係,等於關係沒被預編譯、退回 O(N²)。
**變更**
- `wiki-init.md``docs/SKILL.md``## 關聯` 升級成 **typed-edge 三元組**`[[A]] >> 謂詞 >> [[B]]`。下游 ingest 可直接 parse 出帶類型的有向邊,全局 graph 不必再讀卡片內容就知道關係。
- 規則:① 方向性——`A >> 謂詞 >> B` 須讀成「A(謂詞)B」一句通順的話,順序=主→賓真實方向;② 謂詞用動詞/動詞短語(天然帶方向);③ 謂詞自由書寫不受控詞彙(下游 embedding 會聚類同義謂詞,但方向靠書寫順序保證);④ 向後相容:純 `[[A]]` 仍合法(無類型邊)。
- `>>` 為分隔語法,repo 可自選符號,全程一致即可。
---
## 1.4.1 — wiki = AI 改寫的記憶(拿掉索引模式)+ 量大建議 Haiku(issue #4
**修正 1.4.0 的方向**:1.4.0 把「索引 vs 改寫」做成兩種並列模式,預設一般專案走索引、只有 vault 走改寫。這方向錯了——
+12 -3
View File
@@ -106,12 +106,21 @@ else
## 關聯
- [[相關 wiki 頁面]]
- [[本主題]] >> 謂詞(動詞短語) >> [[相關主題]]
- [[原子筆記]] >> 是其最小單元 >> [[卡片盒筆記法]]
```
### 使用 `[[wikilink]]` 語法
### 使用 typed-edge 三元組(不只裸 `[[wikilink]]`
整理時,如果發現內容與其他 wiki 頁面有關聯,加上 `[[頁面名稱]]` 連結。這是 Karpathy LLM Wiki 的核心機制——知識會互相連結,不是孤立的筆記
整理時,發現內容與其他頁面有關聯,用**帶語義的三元組**寫進 `## 關聯`,而非只列裸 `[[頁面]]`。裸 `[[A]]` 只說「有關」、沒說關係,下游要建 knowledge graph 還得回讀兩張卡;三元組把關係也預編譯,ingest 直接 parse 出帶類型的有向邊
格式 `A >> 謂詞 >> B`,規則:
1. **方向性**:必須讀成「A(謂詞)B」一句通順的話;A、B 順序=主→賓真實方向。
2. **謂詞用動詞 / 動詞短語**(反駁、奠基於、是…的實作),天然帶方向。
3. **謂詞自由書寫**,不受控詞彙;下游對謂詞 embedding 時同義謂詞會自動聚類,但方向仍靠書寫順序保證。
4. **向後相容**:純 `[[A]]` 仍合法(無類型邊),盡量補謂詞。
`>>` 為分隔語法,全程一致即可。這是 Karpathy LLM Wiki「知識互連」的強化版——連結不只存在,還帶類型與方向。
---
+1 -1
View File
@@ -1 +1 @@
1.4.1
1.5.0
+12 -2
View File
@@ -96,7 +96,7 @@ docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,te
- **概念原子化**:一個 wiki 頁面講一個主題,不是一篇原文對一頁。原文太雜就拆,多份相關原文就合。
- **自包含**:讀 wiki 條目就懂,不必回去翻原文。把口語、重複、時間順序的流水帳,改寫成結構化的知識。
- **保留來源指針**:每條標 `**來源**:原文相對路徑`,是為了可追溯,不是要使用者回去讀。
- **互相連結**:用 `[[頁面名稱]]` 連到相關條目(Karpathy LLM Wiki 的核心——知識互連,不是孤島)。
- **互相連結typed-edge 三元組)**`## 關聯` 不要只列裸 `[[頁面]]`——那只說「有關」,沒說關係是什麼,下游要建 knowledge graph 還得回讀兩張卡。改寫成帶語義的三元組(見下方規則)。
wiki 條目格式:
```markdown
@@ -112,9 +112,19 @@ wiki 條目格式:
- [改寫後的要點,自包含、不依賴原文]
## 關聯
- [[相關 wiki 頁面]]
- [[本主題]] >> 謂詞(動詞短語) >> [[相關主題]]
- [[原子筆記]] >> 是其最小單元 >> [[卡片盒筆記法]]
- [[筆記墳場]] >> 是的反面教訓 >> [[筆記要重複使用而非複製貼上]]
```
**typed-edge 規則**(把「關係」也預編譯,下游 ingest 直接 parse 出帶類型的有向邊):
1. **方向性**`A >> 謂詞 >> B` 必須能讀成「A(謂詞)B」一句通順的話;A、B 順序就是主→賓的真實方向。
2. **謂詞用動詞 / 動詞短語**(反駁、奠基於、是…的實作),動詞天然帶方向。
3. **謂詞自由書寫,不受控詞彙**:下游若對謂詞做 embedding,同義謂詞會自動聚類;但 embedding 分不清方向,方向仍靠書寫順序保證。
4. **向後相容**:純 `[[A]]` 仍合法(視為無類型邊),但盡量補謂詞。
> `>>` 是分隔語法,repo 可自選慣例符號——但同一個 repo 全程一致。
INDEX.md 是**概念索引**,指向 wiki 內部條目(非原文):
```markdown
## 概念索引