feat: 安裝結構收進 system-dev/(不污染用戶根目錄)+ 舊版自動遷移 + bump 1.9.0

工具產物原散在用戶根目錄(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>
This commit is contained in:
2026-06-26 15:13:43 +08:00
parent c95705c286
commit ecf1f882c6
27 changed files with 283 additions and 166 deletions
+16 -16
View File
@@ -7,7 +7,7 @@
## 絕對鐵律(違反 = 停手)
1. **任何 code 變動前必須有對應 SDD**`docs/3-specs/[子系統]/design.md`
1. **任何 code 變動前必須有對應 SDD**`system-dev/docs/3-specs/[子系統]/design.md`
2. [技術棧限制,例如:前端只用 React,不引入其他框架]
3. [其他專案特定限制]
@@ -19,15 +19,15 @@
開始任一任務,按順序:
1.`.claude/wiki/status.md`3 分鐘,了解當前狀態)
2. 確認有對應 SDD`docs/3-specs/`
1.`system-dev/wiki/status.md`3 分鐘,了解當前狀態)
2. 確認有對應 SDD`system-dev/docs/3-specs/`
3. 在回覆開頭宣告:
```
📋 已讀 SDD<路徑>
🎯 對應 task<編號>
🚧 執行範圍:<會動哪些檔案>
```
4. 完成後更新 `.claude/wiki/status.md`
4. 完成後更新 `system-dev/wiki/status.md`
---
@@ -35,9 +35,9 @@
| 檔案 | 時機 | 用途 |
|------|------|------|
| `.claude/wiki/status.md` | session 開始第一件事 | 當前進度、下一步 |
| `.claude/wiki/mistakes.md` | 做新功能前 | 已知誤解 + 快速檢查清單 |
| `.claude/wiki/decisions-summary.md` | 遇到設計判斷時 | 架構決策快速查 |
| `system-dev/wiki/status.md` | session 開始第一件事 | 當前進度、下一步 |
| `system-dev/wiki/mistakes.md` | 做新功能前 | 已知誤解 + 快速檢查清單 |
| `system-dev/wiki/decisions-summary.md` | 遇到設計判斷時 | 架構決策快速查 |
> 開 session 由 `SessionStart` hook 自動注入 status 重點。沒自動接關 → 打 `/wiki-recall`。
> status/wiki 是 **快照非即時狀態**:讀快照 **+ 核實快照**,不盲信。
@@ -52,7 +52,7 @@
| 由誰整理 | 規則檔(採集當下必讀) |
|----------|------------------------|
| **Claude CodeCC** | `/wiki-init`(初始化/採集)、`/wiki-capture`(存結論),規則寫在指令內文 |
| **Claude.aiCowork** | `docs/SKILL.md`skill `wiki-cowork-scan`),與 CC 共用同一套規則 |
| **Claude.aiCowork** | `system-dev/docs/SKILL.md`skill `wiki-cowork-scan`),與 CC 共用同一套規則 |
兩條路徑**輸出格式相同、規則一致**:gloss、typed-edge、標籤的寫法在兩份裡都有,任一方整理過另一方不覆蓋。
@@ -62,9 +62,9 @@
| 檔案 | 內容 |
|------|------|
| `docs/README.md` | 文件分類規則 |
| `docs/3-specs/` | 所有 SDD |
| `docs/2-architecture/decisions/` | 架構決策記錄 |
| `system-dev/docs/README.md` | 文件分類規則 |
| `system-dev/docs/3-specs/` | 所有 SDD |
| `system-dev/docs/2-architecture/decisions/` | 架構決策記錄 |
---
@@ -72,8 +72,8 @@
| 類別 | 位置 |
|------|------|
| 架構決策 | `docs/2-architecture/decisions/` |
| SDD | `docs/3-specs/[子系統]/` |
| 操作手冊 | `docs/4-guides/` |
| 事件記錄 | `docs/5-records/incidents/` |
| 測試報告 | `docs/5-records/test-reports/` |
| 架構決策 | `system-dev/docs/2-architecture/decisions/` |
| SDD | `system-dev/docs/3-specs/[子系統]/` |
| 操作手冊 | `system-dev/docs/4-guides/` |
| 事件記錄 | `system-dev/docs/5-records/incidents/` |
| 測試報告 | `system-dev/docs/5-records/test-reports/` |