docs: 釐清 taxonomy 是受控擴充非凍結(先查重再登記)+ bump 1.6.1
1.6.0「禁止自創」措辭過嚴,碰到新軸會逼 AI 硬塞或偷創。改成: 禁的是繞過字典直接冒新標籤,不是禁新增——遇裝不下的內容先查重 (非同義詞?)、確認是新軸才登記進該 repo 的 TAXONOMY.md 再用。 字典 per-repo,跨 repo 不共用。新增領域軸要慎,形態軸較安全。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -10,6 +10,19 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 1.6.1 — 釐清 taxonomy 是「受控擴充」非「凍結」
|
||||||
|
|
||||||
|
1.6.0 把標籤字典寫成「禁止自創」,措辭過嚴:碰到現有軸裝不下的新內容時,會逼 AI 硬塞錯標籤或偷偷自創,兩者都比受控擴充差。改成正確的機制:
|
||||||
|
|
||||||
|
- **禁止的是「繞過字典在卡片直接冒新標籤」,不是「新增標籤」**。字典**可擴充**。
|
||||||
|
- 流程:遇到裝不下的內容 → ① 先查既有(是真新軸還是同義詞?`知識管理` vs `KM` 別重造)→ ② 確實是新軸才登記進字典(附定義)再用。不必停下來問人,但「先查重再登記」不能省。
|
||||||
|
- **字典是 per-repo**:跨 repo 引擎靠各 repo 自己一致的 taxonomy 接合,不是逼所有 repo 共用一份。
|
||||||
|
- **新增領域軸要慎**(影響全庫聚類),形態軸擴充較安全;不確定就先用最接近的並註記「待人類複核」。
|
||||||
|
|
||||||
|
同步 `wiki-init.md`、`docs/SKILL.md`、`TAXONOMY.md` 三處措辭。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 1.6.0 — wiki 完整規劃方式(183 卡實證):三層架構 + frontmatter 標籤 + 多層索引(issue #8/#6/#7)
|
## 1.6.0 — wiki 完整規劃方式(183 卡實證):三層架構 + frontmatter 標籤 + 多層索引(issue #8/#6/#7)
|
||||||
|
|
||||||
在一個中文 Logseq vault(234 篇 pages + journals → 183 張原子卡、571 條 typed-edge)完整跑了一輪 LLM Wiki,把「對 AI 最優」的規劃方式定案。一次納入 `wiki-init.md` 與 `docs/SKILL.md`(CC / Cowork 兩路徑一致):
|
在一個中文 Logseq vault(234 篇 pages + journals → 183 張原子卡、571 條 typed-edge)完整跑了一輪 LLM Wiki,把「對 AI 最優」的規劃方式定案。一次納入 `wiki-init.md` 與 `docs/SKILL.md`(CC / Cowork 兩路徑一致):
|
||||||
|
|||||||
+2
-2
@@ -118,7 +118,7 @@ tags: [知識管理, AI協作, 方法論]
|
|||||||
|
|
||||||
```
|
```
|
||||||
INDEX.md ← 頂層:標籤視圖(非資料夾列表)
|
INDEX.md ← 頂層:標籤視圖(非資料夾列表)
|
||||||
TAXONOMY.md ← 標籤字典(禁止自創標籤)
|
TAXONOMY.md ← 標籤字典(受控擴充:先查重再登記)
|
||||||
cards/<bucket>/
|
cards/<bucket>/
|
||||||
├── 00-INDEX.md ← 桶子索引(固定名,容器:只連不重寫)
|
├── 00-INDEX.md ← 桶子索引(固定名,容器:只連不重寫)
|
||||||
└── <概念全名>.md ← 概念原子卡
|
└── <概念全名>.md ← 概念原子卡
|
||||||
@@ -126,7 +126,7 @@ cards/<bucket>/
|
|||||||
|
|
||||||
- **資料夾只是儲存桶,分類由 frontmatter `tags:` 承載**——不繼承原稿目錄,由 AI 重新組織。
|
- **資料夾只是儲存桶,分類由 frontmatter `tags:` 承載**——不繼承原稿目錄,由 AI 重新組織。
|
||||||
- **桶子索引固定名 `00-INDEX.md`**:`00-` 排序最前、一眼可辨,載入任何桶先讀它。
|
- **桶子索引固定名 `00-INDEX.md`**:`00-` 排序最前、一眼可辨,載入任何桶先讀它。
|
||||||
- **frontmatter `tags:` 而非行內 `#tag`**:內文常用 `#`(如 `#猜想`),行內標籤會讓 ingest 分不清「分類」與「內文範例」污染 graph;frontmatter 零歧義。標籤只能用 `TAXONOMY.md` 列出的,**禁止自創**。
|
- **frontmatter `tags:` 而非行內 `#tag`**:內文常用 `#`(如 `#猜想`),行內標籤會讓 ingest 分不清「分類」與「內文範例」污染 graph;frontmatter 零歧義。標籤只能用 `TAXONOMY.md` 列出的;**禁止繞過字典在卡片直接冒新標籤**,但字典可受控擴充(遇新軸先查重、確認非同義詞,再登記進本 repo 的 TAXONOMY.md)。
|
||||||
- **麵包屑帶路徑**:H1 次行 `← [[<bucket>/00-INDEX]]`。指 `00-INDEX` 因固定名跨桶撞名,**一律帶路徑**;卡片間連結用裸 `[[卡名]]`。
|
- **麵包屑帶路徑**:H1 次行 `← [[<bucket>/00-INDEX]]`。指 `00-INDEX` 因固定名跨桶撞名,**一律帶路徑**;卡片間連結用裸 `[[卡名]]`。
|
||||||
|
|
||||||
### 使用 typed-edge 三元組(不只裸 `[[wikilink]]`)
|
### 使用 typed-edge 三元組(不只裸 `[[wikilink]]`)
|
||||||
|
|||||||
@@ -1 +1 @@
|
|||||||
1.6.0
|
1.6.1
|
||||||
|
|||||||
@@ -68,7 +68,7 @@ wiki 採**三層 + 標籤橫切**架構(183 卡實證,issue #8):
|
|||||||
```
|
```
|
||||||
.claude/wiki/
|
.claude/wiki/
|
||||||
├── INDEX.md ← 頂層:標籤視圖(不是資料夾列表)
|
├── INDEX.md ← 頂層:標籤視圖(不是資料夾列表)
|
||||||
├── TAXONOMY.md ← 標籤字典(分類骨架,禁止自創標籤)
|
├── TAXONOMY.md ← 標籤字典(分類骨架,受控擴充:先查重再登記)
|
||||||
├── status.md / mistakes.md / decisions-summary.md
|
├── status.md / mistakes.md / decisions-summary.md
|
||||||
└── cards/
|
└── cards/
|
||||||
└── <bucket>/ ← 儲存桶(一般專案沿用 docs 分類;vault 由 AI 重新組織)
|
└── <bucket>/ ← 儲存桶(一般專案沿用 docs 分類;vault 由 AI 重新組織)
|
||||||
@@ -142,10 +142,11 @@ tags: [知識管理, AI協作, 方法論]
|
|||||||
**frontmatter 標籤分類**(issue #8):
|
**frontmatter 標籤分類**(issue #8):
|
||||||
- **用 frontmatter `tags:` 而非行內 `#tag`**:卡片內文常大量用 `#`(講筆記法時的 `#猜想`、`#book100`),分類標籤若也行內 `#`,下游 ingest 無法區分「分類」與「內文範例」會污染 graph。frontmatter 與內文完全分開,零歧義。
|
- **用 frontmatter `tags:` 而非行內 `#tag`**:卡片內文常大量用 `#`(講筆記法時的 `#猜想`、`#book100`),分類標籤若也行內 `#`,下游 ingest 無法區分「分類」與「內文範例」會污染 graph。frontmatter 與內文完全分開,零歧義。
|
||||||
- **用標籤而非資料夾分類**:資料夾=強制單一歸屬;標籤=多重歸屬。一張卡可同時屬知識管理+AI協作+架構設計,硬塞一個資料夾會在其他檢索角度漏掉。
|
- **用標籤而非資料夾分類**:資料夾=強制單一歸屬;標籤=多重歸屬。一張卡可同時屬知識管理+AI協作+架構設計,硬塞一個資料夾會在其他檢索角度漏掉。
|
||||||
- **雙軸 taxonomy**(寫進 `TAXONOMY.md` 當字典,**禁止自創**以保持 graph 乾淨):
|
- **雙軸 taxonomy**(寫進 `TAXONOMY.md` 當字典;**受控擴充**,非凍結):
|
||||||
- 領域(主軸,1-3 個):如 知識管理/學習認知/AI協作/生產力/系統設計/工具教學
|
- 領域(主軸,1-3 個):如 知識管理/學習認知/AI協作/生產力/系統設計/工具教學
|
||||||
- 形態(副軸,0-2 個):方法論/工具實作/觀點主張/架構設計/案例經驗
|
- 形態(副軸,0-2 個):方法論/工具實作/觀點主張/架構設計/案例經驗
|
||||||
- 一般開發專案的軸可不同(如 子系統/層級/決策類型),由 AI 依專案性質提出、寫進 TAXONOMY.md。
|
- 一般開發專案的軸可不同(如 子系統/層級/決策類型),由 AI 依專案性質提出、寫進 TAXONOMY.md。
|
||||||
|
- **遇到現有軸裝不下的內容**:先查是否只是現有標籤的同義詞;確實是新軸才加進 TAXONOMY.md(附定義)再用——**禁止繞過字典在卡片直接冒新標籤**。字典是 per-repo,跨 repo 不必共用。
|
||||||
|
|
||||||
**typed-edge 規則**(issue #5,把「關係」也預編譯,下游 ingest 直接 parse 出帶類型的有向邊):
|
**typed-edge 規則**(issue #5,把「關係」也預編譯,下游 ingest 直接 parse 出帶類型的有向邊):
|
||||||
1. **方向性**:`A >> 謂詞 >> B` 必須讀成「A(謂詞)B」一句通順的話;A、B 順序就是主→賓真實方向。
|
1. **方向性**:`A >> 謂詞 >> B` 必須讀成「A(謂詞)B」一句通順的話;A、B 順序就是主→賓真實方向。
|
||||||
|
|||||||
@@ -1,8 +1,16 @@
|
|||||||
# TAXONOMY.md — 標籤字典
|
# TAXONOMY.md — 標籤字典(本 repo 專屬)
|
||||||
|
|
||||||
> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**,禁止自創。
|
> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**。
|
||||||
> 為什麼禁止自創:標籤是 graph 的分類骨架,自由增生會讓同類卡片分散、下游聚類失準。
|
> 這不是凍結——字典**可以擴充**,只是**禁止繞過字典在卡片裡直接冒新標籤**。
|
||||||
> 要新增標籤 → 先加進這份字典,再用。維護者:CC(由 /wiki-init 初始化、隨 wiki 演進補充)。
|
> 維護者:CC(由 /wiki-init 初始化、隨 wiki 演進受控擴充)。
|
||||||
|
>
|
||||||
|
> **遇到現有軸都裝不下的內容時,照這個流程(先查、後擴、登記)**:
|
||||||
|
> 1. **先查既有**:現有標籤真的都不合,還是只是同義詞?(`知識管理` vs `KM` vs `筆記管理` 是同一軸,別重造)
|
||||||
|
> 2. **確實是新軸** → 把新標籤加進本檔(附一句定義),再用。不必停下來問人,但「先登記再使用」這道查核不能省。
|
||||||
|
> 3. 自由增生才是要防的——同義標籤散開會讓同類卡片分散、下游聚類失準。受控擴充(先查重、再登記)不會。
|
||||||
|
>
|
||||||
|
> **字典是每個 repo 各自的**:跨 repo 引擎靠各 repo 自己一致的 taxonomy 接合,不是逼所有 repo 共用一份。
|
||||||
|
> 知識型 vault 的領域軸(知識管理/學習認知)和開發 repo(子系統/基礎設施)本來就該不同。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -36,6 +44,7 @@
|
|||||||
|
|
||||||
## 規則
|
## 規則
|
||||||
|
|
||||||
1. **禁止自創**:要用新標籤先加進本檔。
|
1. **先查重、再登記、才使用**:禁止繞過字典在卡片直接冒新標籤;新標籤先確認非現有同義詞,加進本檔(附定義)再用。
|
||||||
2. **領域 vs 形態分開**:領域是「講什麼主題」,形態是「以什麼形式呈現」,不要混。
|
2. **領域 vs 形態分開**:領域是「講什麼主題」,形態是「以什麼形式呈現」,不要混。
|
||||||
3. **頂層 INDEX.md 的標籤視圖依本字典的軸聚類**——字典改了,INDEX 視圖跟著更新。
|
3. **頂層 INDEX.md 的標籤視圖依本字典的軸聚類**——字典改了,INDEX 視圖跟著更新。
|
||||||
|
4. **新增領域軸要慎**:領域是檢索骨架,動它影響全庫聚類;形態軸(呈現形式)擴充較安全。不確定就先用現有最接近的,並在卡片或本檔註記「待人類複核此分類」。
|
||||||
|
|||||||
Reference in New Issue
Block a user