@@ -61,20 +61,34 @@
### 第三步：建立缺少的結構
只建立不存在的目錄和檔案，**已有的一律不動**：
只建立不存在的目錄和檔案，**已有的一律不動**。
目錄 ：
wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8 ） ：
```
.claude/wiki/
├── INDEX.md ← 頂層：標籤視圖（不是資料夾列表）
├── TAXONOMY.md ← 標籤字典（分類骨架，禁止自創標籤）
├── status.md / mistakes.md / decisions-summary.md
└── cards/
└── <bucket>/ ← 儲存桶（一般專案沿用 docs 分類；vault 由 AI 重新組織）
├── 00-INDEX.md ← 桶子索引（固定名，容器：只連不重寫，H2/H3 分節）
└── <概念全名>.md ← 概念原子卡（一概念一檔，自包含）
```
關鍵原則：**資料夾只是儲存桶，分類由 frontmatter 標籤承載**。資料夾名不該硬繼承原稿目錄——原稿目錄是「人為了整理草稿」分的，wiki 連分類都該由 AI 重新組織。
> **桶子索引固定叫 `00-INDEX.md`**（
一般專案仍可同時建 `docs/` 分類樹（SDD 等）：
```
docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,test-reports},6-user}
.claude/wiki/
```
（純 PKM vault 不需要 `docs/` 分類樹時，可 只建 `.claude/wiki/` 。）
（純 PKM vault 不需要 `docs/` 分類樹時，只建 `.claude/wiki/` 。）
檔案（不存在才建）：
- `.claude/wiki/INDEX.md`
- `.claude/wiki/status.md`
- `.claude/wiki/mistakes.md`
- `.claude/wiki/decisions-summary.md`
- `.claude/wiki/INDEX.md` 、 `TAXONOMY.md`
- `.claude/wiki/status.md` 、 `mistakes.md` 、 `decisions-summary.md`
- `docs/README.md` （一般專案才需要）
### 第四步：訪談（每次一個問題）
@@ -91,57 +105,79 @@ docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,te
（第二步確認後執行）
**不搬動原文 ** 。逐份讀 raw source，改寫萃取成 `.claude/wiki /` 裡的自包含條目 ：
**不搬動原文 ** 。逐份讀 raw source，改寫萃取成 `cards/<bucket> /` 裡的自包含原子卡 ：
- **概念原子化**：一個 wiki 頁面 講一個主題 ，不是一篇原文對一頁 。原文太雜就拆，多份相關原文就合。
- **自包含**：讀 wiki 條目 就懂，不必回去翻原文。把口語、重複、時間順序的 流水帳， 的 知識。
- **保留來源指針**：每條 標 `**來源**：原文相對路徑` ， 是為了 可追溯，不是要使用者回去讀。
- **互相連結（typed-edge 三元組）**： `## 關聯` 不要只列裸 `[[頁面]]` ——那只說「有關」，沒說關係是什麼，下游要建 knowledge graph 還得回讀兩張卡。改寫成帶語義的三元組（見下方規則） 。
- **概念原子化**：一張卡 講一個概念 ，不是一篇原文對一張卡 。原文太雜就拆，多份相關原文就合。
- **自包含**：讀卡 就懂，不必回去翻原文。把口語、重複、流水帳改寫成結構化知識，
- **保留來源指針**：每卡 標 `**來源**：原文相對路徑` ， 為 可追溯，不是要使用者回去讀。
- **frontmatter 標籤分類**（見下方）：分類走 frontmatter `tags:` ，不靠資料夾、不靠行內 `#tag`
- **互相連結（typed-edge 三元組）**： `## 關聯` 不只列裸 `[[頁面]]` ，改寫成帶語義的三元組（見下方）。
wiki 條目格式 ：
卡片格式（每張卡） ：
``` markdown
# [主題名稱]
---
tags: [知識管理, AI協作, 方法論]
---
# 概念全名
← [[<bucket>/00-INDEX]]
**來源 ** ： `[raw source 相對路徑]`
**最後更新 ** ：
## 摘要
[2-3 句說明這個主題的 核心]
[一句話 核心]
## 重點
- [改寫後 的要點，自包含、 不依賴原文]
- [自包含 改寫的要點，不依賴原文]
## 關聯
- [[本主題 ]] >> 謂詞（動詞短語） >> [[相關主題 ]]
- [[本卡 ]] >> 謂詞（動詞短語） >> [[他卡 ]]
- [[原子筆記]] >> 是其最小單元 >> [[卡片盒筆記法]]
- [[筆記墳場]] >> 是的反面教訓 >> [[筆記要重複使用而非複製貼上]]
```
**typed-edge 規則 ** （把「關係」也預編譯，下游 ingest 直接 parse 出帶類型的有向邊）：
1. **方向性 ** ： `A >> 謂詞 >> B` 必須能讀成「A（謂詞）B」一句通順的話；A、B 順序就是主→賓的真實方向 。
**麵包屑用帶路徑 wikilink ** （ #7 ）：H1 次行放 `← [[<bucket>/00-INDEX]]` 指回桶子索引。
桶子索引固定名 `00-INDEX` 跨桶會撞名，故**指 00-INDEX 一律帶路徑**（ `[[pkm/00-INDEX]]` ， `[[卡名]]` （卡名唯一，不需路徑） 。
**frontmatter 標籤分類 ** （ #8 ）：
- **用 frontmatter `tags:` 而非行內 `#tag` **：卡片內文常大量用 `#` （講筆記法時的 `#猜想` 、`#book100` ），分類標籤若也行內 `#` ，下游 ingest 無法區分「分類」與「內文範例」會污染 graph。frontmatter 與內文完全分開，零歧義。
- **用標籤而非資料夾分類**：資料夾＝強制單一歸屬；標籤＝多重歸屬。一張卡可同時屬知識管理＋AI協作＋架構設計，硬塞一個資料夾會在其他檢索角度漏掉。
- **雙軸 taxonomy**（寫進 `TAXONOMY.md` 當字典，**禁止自創**以保持 graph 乾淨）：
- 領域（主軸，1-3 個）：如 知識管理／學習認知／AI協作／生產力／系統設計／工具教學
- 形態（副軸，0-2 個）：方法論／工具實作／觀點主張／架構設計／案例經驗
- 一般開發專案的軸可不同（如 子系統／層級／決策類型），由 AI 依專案性質提出、寫進 TAXONOMY.md。
**typed-edge 規則 ** （ #5 ，把「關係」也預編譯，下游 ingest 直接 parse 出帶類型的有向邊）：
1. **方向性 ** ： `A >> 謂詞 >> B` 必須讀成「A（謂詞）B」一句通順的話；A、B 順序就是主→賓真實方向。
2. **謂詞用動詞 / 動詞短語 ** （反駁、奠基於、是…的實作），動詞天然帶方向。
3. **謂詞自由書寫，不受控詞彙 ** ：下游若 對謂詞做 embedding， embedding 分不清方向， 方向仍靠書寫順序保證。
4. **向後相容 ** ：純 `[[A]]` 仍合法（視為無類型邊），但 盡量補謂詞。
3. **謂詞自由書寫，不受控詞彙 ** ：下游對謂詞 embedding 時 同義謂詞會自動聚類；但方向仍靠書寫順序保證。
4. **向後相容 ** ：純 `[[A]]` 仍合法（視為無類型邊），盡量補謂詞。
> `>>` 是分隔語法，repo 可自選慣例符號——但同一個 repo 全程一致。
> `>>` 是分隔語法，repo 可自選符號，但 全程一致。
INDEX.md 是**概念索引**，指向 wiki 內部條目（非原文）：
``` markdown
## 概念索引
| 條目 | 來源 | 一句話 | 最後更新 |
|------|------|--------|----------|
| [[主題名稱]] | `raw/path.md` | 一句話摘要 | YYYY-MM-DD |
```
** INDEX.md 是標籤視圖 ** （非資料夾列表）， `00-INDEX.md` 是桶內容器（只連不重寫，H2/H3 分節）。
頂層索引指桶子索引帶路徑：`[[pkm/00-INDEX]]` 。
> 與 claude.ai Cowork 的 `docs/SKILL.md` 改寫邏輯一致，兩條路徑（CC / Cowork）產出同一種 wiki。
### 第六步：完成報告
### 第六步：完成報告 + 驗證
完成後**驗證原文 0 動**（踩過的坑，issue #8 ）：
```
git status --short pages/ journals/ # 或一般專案的 docs/ ——須 0 新增 0 修改
```
> **改寫時必守**（
> 1. **絕不寫入 raw source**：
> 2. **檔名 = 卡片全名**，否則 `[[全名]]` 對不到檔。冒號用全形「：」、斜線用全形「／」，**全程一種字元**，避免 `/`、`∕`、`：` 混用斷鏈。
> 3. **量大用 Haiku 並行改寫**，主模型只切概念邊界＋審稿＋修跨資料夾斷鏈。
告知：
```
✅ wiki-init 完成
建立了：[列出新建的目錄和檔案]
跳過了：[列出已有因此不動的]
改寫了：[N 份原文 → M 條 wiki 條目 ]
改寫了：[N 份原文 → M 張原子卡、K 條 typed-edge ]
原文驗證：pages/ journals/ git status 0 異動 ✅
下一步：用 /wiki-capture 把重要決策存進 wiki
```
