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:
+16
-16
@@ -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 Code(CC)** | `/wiki-init`(初始化/採集)、`/wiki-capture`(存結論),規則寫在指令內文 |
|
||||
| **Claude.ai(Cowork)** | `docs/SKILL.md`(skill `wiki-cowork-scan`),與 CC 共用同一套規則 |
|
||||
| **Claude.ai(Cowork)** | `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/` |
|
||||
|
||||
Reference in New Issue
Block a user