# wiki-architecture — Tasks

> 權威來源：此檔案是進度真相。動手前標 [🔄]，完成立刻標 [x]。

---

## Phase 0：審核（前置）

- [x] 0.1 design.md 經用戶審核通過（push/pull 判準、push 三項形態、INDEX 多角度）

---

## Phase 1：規則文件（wiki-init + SKILL）

> 前置：Phase 0

- [x] 1.1 wiki-init.md 寫入 push/pull 判準 + 三類 push（status全文/principles全文/mistakes摘要）
  - 驗收：CC 讀 wiki-init 能判斷一個內容該 push 還 pull
- [x] 1.2 wiki-init.md 新增 principles 檔的建立與維護規則（一行一條、條數上限）
- [x] 1.3 wiki-init.md decisions-summary 重定位為「pull / INDEX 決策視圖」，既有內容相容
- [x] 1.4 SKILL.md（Cowork）同步上述規則，CC/Cowork 一致
  - 驗收：兩來源檔 push/pull 規則 byte 對齊（除路徑）

## Phase 2：INDEX 升級為多角度視圖

> 前置：Phase 1

- [x] 2.1 INDEX.md 範本：從「標籤視圖」升級為「多角度入口」（標籤/決策/原則…角度）
- [x] 2.2 明示「新增角度 = 改 INDEX 一節，不開新檔、不問用戶」
- [x] 2.3 principles/mistakes 在 INDEX 留 pull 指標
  - 驗收：INDEX 範本含多角度說明 + 新增角度的自助規則

## Phase 3：push 機制（session-start hook）

> 前置：Phase 1

- [x] 3.1 session-start-recall.sh 擴充：注入 status 全文 + principles 全文 + mistakes 標題清單
- [x] 3.2 context 保護：principles 條數上限檢查、mistakes 只注入標題+一行
- [x] 3.3 bash -n + 沙盒測試（三類都有時注入正確、量受控）
  - 驗收：開 session 三類都被動出現，總量有節制

## Phase 4：新增 principles 範本 + 種子原則

> 前置：Phase 1-3

- [x] 4.1 建 template/system-dev/wiki/principles.md 範本
- [x] 4.2 install.sh download + update.sh keep_file（用戶資料，永不覆蓋）
- [x] 4.3 種子原則寫入（dev repo 自用 wiki）：不污染用戶根目錄、目標用戶 low-code、wiki 主要給 AI 看、內部文件不推
  - 驗收：開 session 這些原則被動出現在 context

## Phase 5：版本、文件、提交

- [x] 5.1 bump（中版號，新增 principles 功能）+ 兩 VERSION 同步
- [x] 5.2 CHANGELOG
- [x] 5.3 commit + push（已隨 1.10.0~1.11.0 推送）

---

## 完成定義
- [x] 所有 tasks [x]
- [x] design.md 驗收標準全過
- [x] 實證：CC 開 session 會被動看見 principles（本 session SessionStart hook 已注入 9 條，成立）

---

## 下游驗收（2026-06-26，KB 端 183 卡實跑壓測）

> 採集規範升級（gloss / `## 實體` / typed-edge / 端點對齊護欄）首次真實 ingest 全量驗證，全綠：

| 驗收項 | 結果 |
|--------|------|
| 結構齊全（gloss + 實體 + 兩層各 1 份） | ✅ 183/183 |
| 有 gloss | ✅ 183/183 |
| 內文三元組總數 | 1,029 條 |
| 端點對不齊 / 三段式 | ✅ 0 |
| raw source 鐵律（pages/journals 0 異動） | ✅ |
| 內文層無誤用 wikilink | ✅ 乾淨 |

- 放量分三批、驗收驅動：試跑 12 → 補硬自檢 → 0；放量 170 → 殘留 26 → 修正批 15 → 殘留 1 → 手修；全量 0 缺陷。
- 印證 issue #11 的「端點硬自檢」護欄（Haiku 量產 14→0）在真實規模成立。
- 連帶修了 KB 端 CLAUDE.md 6 處過時路徑（`.claude/wiki/` → `system-dev/wiki/`），即 1.9.3 hook 提示的場景。

**狀態：結案。** 採集規範 / push 機制 / `## 實體` 都已下游實證，無待驗證項。