From bc0fe3f01ce2d2fd7f363bb2c6d8180d1c44e156 Mon Sep 17 00:00:00 2001 From: richblack Date: Fri, 26 Jun 2026 01:28:21 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E9=87=90=E6=B8=85=20taxonomy=20?= =?UTF-8?q?=E6=98=AF=E5=8F=97=E6=8E=A7=E6=93=B4=E5=85=85=E9=9D=9E=E5=87=8D?= =?UTF-8?q?=E7=B5=90=EF=BC=88=E5=85=88=E6=9F=A5=E9=87=8D=E5=86=8D=E7=99=BB?= =?UTF-8?q?=E8=A8=98=EF=BC=89+=20bump=201.6.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1.6.0「禁止自創」措辭過嚴，碰到新軸會逼 AI 硬塞或偷創。改成： 禁的是繞過字典直接冒新標籤，不是禁新增——遇裝不下的內容先查重 （非同義詞？）、確認是新軸才登記進該 repo 的 TAXONOMY.md 再用。 字典 per-repo，跨 repo 不共用。新增領域軸要慎，形態軸較安全。 Co-Authored-By: Claude Opus 4.8 (1M context) --- CHANGELOG.md | 13 +++++++++++++ docs/SKILL.md | 4 ++-- template/.claude/VERSION | 2 +- template/.claude/commands/wiki-init.md | 5 +++-- template/.claude/wiki/TAXONOMY.md | 19 ++++++++++++++----- 5 files changed, 33 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 73fb073..b4a9270 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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） 在一個中文 Logseq vault（234 篇 pages + journals → 183 張原子卡、571 條 typed-edge）完整跑了一輪 LLM Wiki，把「對 AI 最優」的規劃方式定案。一次納入 `wiki-init.md` 與 `docs/SKILL.md`（CC / Cowork 兩路徑一致）： diff --git a/docs/SKILL.md b/docs/SKILL.md index 728068a..fa5cf95 100644 --- a/docs/SKILL.md +++ b/docs/SKILL.md @@ -118,7 +118,7 @@ tags: [知識管理, AI協作, 方法論] ``` INDEX.md ← 頂層：標籤視圖（非資料夾列表） -TAXONOMY.md ← 標籤字典（禁止自創標籤） +TAXONOMY.md ← 標籤字典（受控擴充：先查重再登記） cards// ├── 00-INDEX.md ← 桶子索引（固定名，容器：只連不重寫） └── <概念全名>.md ← 概念原子卡 @@ -126,7 +126,7 @@ cards// - **資料夾只是儲存桶，分類由 frontmatter `tags:` 承載**——不繼承原稿目錄，由 AI 重新組織。 - **桶子索引固定名 `00-INDEX.md`**：`00-` 排序最前、一眼可辨，載入任何桶先讀它。 -- **frontmatter `tags:` 而非行內 `#tag`**：內文常用 `#`（如 `#猜想`），行內標籤會讓 ingest 分不清「分類」與「內文範例」污染 graph；frontmatter 零歧義。標籤只能用 `TAXONOMY.md` 列出的，**禁止自創**。 +- **frontmatter `tags:` 而非行內 `#tag`**：內文常用 `#`（如 `#猜想`），行內標籤會讓 ingest 分不清「分類」與「內文範例」污染 graph；frontmatter 零歧義。標籤只能用 `TAXONOMY.md` 列出的；**禁止繞過字典在卡片直接冒新標籤**，但字典可受控擴充（遇新軸先查重、確認非同義詞，再登記進本 repo 的 TAXONOMY.md）。 - **麵包屑帶路徑**：H1 次行 `← [[/00-INDEX]]`。指 `00-INDEX` 因固定名跨桶撞名，**一律帶路徑**；卡片間連結用裸 `[[卡名]]`。 ### 使用 typed-edge 三元組（不只裸 `[[wikilink]]`） diff --git a/template/.claude/VERSION b/template/.claude/VERSION index dc1e644..9c6d629 100644 --- a/template/.claude/VERSION +++ b/template/.claude/VERSION @@ -1 +1 @@ -1.6.0 +1.6.1 diff --git a/template/.claude/commands/wiki-init.md b/template/.claude/commands/wiki-init.md index 5037bce..c04a87e 100644 --- a/template/.claude/commands/wiki-init.md +++ b/template/.claude/commands/wiki-init.md @@ -68,7 +68,7 @@ wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8）： ``` .claude/wiki/ ├── INDEX.md ← 頂層：標籤視圖（不是資料夾列表） -├── TAXONOMY.md ← 標籤字典（分類骨架，禁止自創標籤） +├── TAXONOMY.md ← 標籤字典（分類骨架，受控擴充：先查重再登記） ├── status.md / mistakes.md / decisions-summary.md └── cards/ └── / ← 儲存桶（一般專案沿用 docs 分類；vault 由 AI 重新組織） @@ -142,10 +142,11 @@ tags: [知識管理, AI協作, 方法論] **frontmatter 標籤分類**（issue #8）： - **用 frontmatter `tags:` 而非行內 `#tag`**：卡片內文常大量用 `#`（講筆記法時的 `#猜想`、`#book100`），分類標籤若也行內 `#`，下游 ingest 無法區分「分類」與「內文範例」會污染 graph。frontmatter 與內文完全分開，零歧義。 - **用標籤而非資料夾分類**：資料夾＝強制單一歸屬；標籤＝多重歸屬。一張卡可同時屬知識管理＋AI協作＋架構設計，硬塞一個資料夾會在其他檢索角度漏掉。 -- **雙軸 taxonomy**（寫進 `TAXONOMY.md` 當字典，**禁止自創**以保持 graph 乾淨）： +- **雙軸 taxonomy**（寫進 `TAXONOMY.md` 當字典；**受控擴充**，非凍結）： - 領域（主軸，1-3 個）：如 知識管理／學習認知／AI協作／生產力／系統設計／工具教學 - 形態（副軸，0-2 個）：方法論／工具實作／觀點主張／架構設計／案例經驗 - 一般開發專案的軸可不同（如 子系統／層級／決策類型），由 AI 依專案性質提出、寫進 TAXONOMY.md。 + - **遇到現有軸裝不下的內容**：先查是否只是現有標籤的同義詞；確實是新軸才加進 TAXONOMY.md（附定義）再用——**禁止繞過字典在卡片直接冒新標籤**。字典是 per-repo，跨 repo 不必共用。 **typed-edge 規則**（issue #5，把「關係」也預編譯，下游 ingest 直接 parse 出帶類型的有向邊）： 1. **方向性**：`A >> 謂詞 >> B` 必須讀成「A（謂詞）B」一句通順的話；A、B 順序就是主→賓真實方向。 diff --git a/template/.claude/wiki/TAXONOMY.md b/template/.claude/wiki/TAXONOMY.md index 647fbd4..7fb61e1 100644 --- a/template/.claude/wiki/TAXONOMY.md +++ b/template/.claude/wiki/TAXONOMY.md @@ -1,8 +1,16 @@ -# TAXONOMY.md — 標籤字典 +# TAXONOMY.md — 標籤字典（本 repo 專屬） -> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**，禁止自創。 -> 為什麼禁止自創：標籤是 graph 的分類骨架，自由增生會讓同類卡片分散、下游聚類失準。 -> 要新增標籤 → 先加進這份字典，再用。維護者：CC（由 /wiki-init 初始化、隨 wiki 演進補充）。 +> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**。 +> 這不是凍結——字典**可以擴充**，只是**禁止繞過字典在卡片裡直接冒新標籤**。 +> 維護者：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 形態分開**：領域是「講什麼主題」，形態是「以什麼形式呈現」，不要混。 3. **頂層 INDEX.md 的標籤視圖依本字典的軸聚類**——字典改了，INDEX 視圖跟著更新。 +4. **新增領域軸要慎**：領域是檢索骨架，動它影響全庫聚類；形態軸（呈現形式）擴充較安全。不確定就先用現有最接近的，並在卡片或本檔註記「待人類複核此分類」。