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:
@@ -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
|
||||
## 概念索引
|
||||
|
||||
Reference in New Issue
Block a user