feat: wiki 資訊架構 push/pull 判準 + principles 原則 push 檔 + bump 1.10.0

從「用戶所有檔案一律改寫成 wiki」前提,用 push(行動前必看見)vs pull(按需查)
重新推導 wiki/ 每個檔存廢——wiki 主要給 AI 看,判準是 CC 做事會不會被動看見。
對應 SDD: wiki-architecture(內部,依原則不推)。

- 新增 principles.md(push 全文):收跨全局原則(不污染根目錄、low-code…),
  原則是會被遺忘的盲區,沒推到眼前 CC 設計時不服從。一行一條 ≤15。
- mistakes 改 push 摘要(標題+症狀,全文按需展開,量大不撐爆 context)
- decisions-summary 降級為 cards + INDEX 決策視圖(既有相容)
- INDEX 升級多角度視圖的家:新增角度只改 INDEX,不開檔不問用戶
- session-start hook 三類 push:principles 全文→status→mistakes 標題;>15 警告
- install 補 principles download;update 加 add_if_missing(補範本/已有則保留)
- push/pull 判準寫進 wiki-init + SKILL,CC/Cowork 共用
- 沙盒驗證:三類注入順序與量受控、add_if_missing 不覆蓋用戶內容、全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-26 16:52:32 +08:00
parent ead3593109
commit 671503fd70
12 changed files with 197 additions and 42 deletions
+12
View File
@@ -10,6 +10,18 @@
---
## 1.10.0 — wiki 資訊架構:push/pull 判準 + principles(原則)push 檔
從「用戶所有檔案一律改寫成 wiki」的新前提,用 **pushCC 行動前必主動看見)vs pull(按需檢索)** 重新推導 wiki/ 每個檔的存廢——因為 wiki 主要是給 AI 看的,判準是「CC 做事時會不會被動看見」,不是分類美學。對應 SDDwiki-architecture。
- **新增 `principles.md`(push 全文)**:收「跨全局設計原則」(如不污染用戶根目錄、目標用戶 low-code)。原則是「會被遺忘的盲區」——沒推到眼前 CC 設計時不會服從。一行一條、≤15 條,累積只改此檔不開新檔。
- **mistakes 改 push 摘要**session-start hook 注入標題清單+一行症狀,全文按需展開(量大不撐爆 context)。
- **decisions-summary 降級為 cards + INDEX 決策視圖**:決策是知識內容=card;既有的保留相容。
- **INDEX 升級為「多角度視圖」的家**:標籤角度、決策角度…新增角度只改 INDEX 一節,不開實體檔、不問用戶。
- **session-start hook 三類 push**principles 全文(最前)→ status 全文 → mistakes 標題;principles >15 條警告。
- install.sh 補 principles downloadupdate.sh 新增 `add_if_missing`(舊用戶升級補範本、已有則保留不覆蓋)。
- push/pull 判準寫進 wiki-init.md 與 SKILL.mdCC/Cowork 共用。
## 1.9.3 — 遷移後 CLAUDE.md 殘留舊路徑:hook 偵測並提示 CC 代修
升級到 1.9.x 後 wiki 已搬到 system-dev/,但 update.sh 鐵則「絕不碰 CLAUDE.md」(用戶資料),導致 CLAUDE.md 內仍寫舊路徑 `.claude/wiki/`,CC 照它找錯位置(KB 端升級後發現)。