Leo
ecf1f882c6
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。
對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。
- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
+ session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
596 B
596 B
CC 已知誤解 + 避坑方法
做新功能前讀一遍。 格式：每條必須有症狀 + 正確做法 + 原因。
快速檢查清單（做任何事前）
- 有對應 SDD 嗎？沒有 → 停手
- 這次修改會影響哪些模組？有沒有連帶破壞？
- 驗收標準是什麼？有客觀證據嗎？
誤解記錄
（初始化時為空，隨專案進行 append）
格式： ⚠️ MISTAKE: [錯誤描述，一句話] 症狀: [CC 通常怎麼表現這個錯] 正確做法: [應該怎麼做] 原因: [為什麼會錯] 日期: [YYYY-MM-DD]