Leo
2a8c259d08
🔴 修的病：這個框架 repo 自己的 5 份 SDD 全部被 .gitignore 擋在版控之外， 只活在一台硬碟上——clone 不到、雲端 CC 讀不到、沒備份。SDD 是進度真相源， 「框架 repo 沒吃自己的狗糧」。 依據 D22（已翻案）：Gitea private 除機敏值外全 push，雲端工人靠 clone，docs 缺＝斷糧； 只有 GitHub mirror 才嚴篩，而 docs 整包已在 github-publish-exclude.txt。 .gitignore 改法：整條擋 → 只擋子項（/*）+ 逐個放行真 SDD。 與 template/ 底下逐位元組相同的自裝副本（TEMPLATE-sdd/、SDD-LIFECYCLE.md）續擋。 新增 docs/3-specs/jdd-dual-profile/（status: draft，等 leo confirm 才升 active）： JDD（PM 軌 root/journeys/角色權限/站號 sprint）與雙 profile 合成一卷， 33 條 task／6 phase，每條掛服務哪條 Gherkin（G1–G7）。 新增 hook 6 支、改既有 hook 1 支。**0 行實作**。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
88 lines
3.7 KiB
Markdown
88 lines
3.7 KiB
Markdown
# install-layout — Tasks
|
||
|
||
> 權威來源：此檔案是進度真相，不是 CLAUDE.md 或對話。
|
||
> 規則：動手前標 [🔄]，完成立刻標 [x]，不批次更新。
|
||
|
||
---
|
||
|
||
## Phase 1：腳本核心（install / update + 遷移）
|
||
|
||
### 前置條件
|
||
- [x] design.md 已審核（用戶批准）
|
||
|
||
### Tasks
|
||
|
||
- [x] 1.1 install.sh：docs/ create_dir+download 落點全改 system-dev/docs/
|
||
- 驗收：✅ grep 無殘留；raw source 偵測段 `RAW_SOURCE="docs/"` 正確保留
|
||
- [x] 1.2 install.sh：.claude/wiki/* 與 .claude/VERSION 落點改 system-dev/
|
||
- 驗收：✅ 落點全 system-dev/；新增 system-dev/VERSION download
|
||
- [x] 1.3 install.sh：新增 create_dir system-dev/wiki/cards + 寫 .gitkeep
|
||
- 驗收：✅ 已加 create_dir + .gitkeep 寫入
|
||
- [x] 1.4 install.sh：scripts 落點改 system-dev/scripts/（一開始就裝）
|
||
- 驗收：✅ 加 SCRIPTS_URL + download install/update 到 system-dev/scripts/
|
||
- [x] 1.5 update.sh：所有路徑改 system-dev/（wiki/docs/scripts/VERSION）
|
||
- 驗收：✅ grep 無殘留；bash -n 過；commands/hooks 正確留 .claude/
|
||
- [x] 1.6 update.sh：新增冪等遷移段（舊位置→system-dev/，保留 wiki/.git，白名單只搬工具 docs）
|
||
- 驗收：✅ 沙盒測試全綠——wiki(含.git commit一致)/VERSION/SKILL/docs 搬移正確、冪等(第二次0項)、用戶自填 docs 保留
|
||
- [x] 1.7 兩腳本 bash -n + 多位元組旁變數 ${} 包好
|
||
- 驗收：✅ install.sh + update.sh bash -n 通過
|
||
|
||
---
|
||
|
||
## Phase 2：路徑引用同步（.md / .sh）
|
||
|
||
> 前置條件：Phase 1 完成
|
||
|
||
- [x] 2.1 CLAUDE.md（template + 根）：鐵律/速查/wiki 讀取表路徑；raw source 宣告維持
|
||
- [x] 2.2 SKILL.md（template + 根）：cards/ 落點改 system-dev/wiki/cards/；raw source 偵測維持
|
||
- [x] 2.3 wiki-init.md（.claude + template）：cards/、工具 docs 示意、SKILL 引用；raw source 偵測維持
|
||
- [x] 2.4 wiki-capture.md / sdd-check.md（.claude + template）：docs/ → system-dev/docs/
|
||
- [x] 2.5 sdd-guard.sh（.claude + template）：7 處 docs/3-specs → system-dev/docs/3-specs
|
||
- [x] 2.6 session-start-recall.sh：STATUS_FILE 路徑 + 新增防呆檢查
|
||
- [x] 2.7 INDEX.md / decisions-summary.md（.claude + template）：docs/2-architecture 引用
|
||
- [x] 2.8 README.md / README.en.md：目錄樹示意 + 安裝後說明
|
||
- 驗收（2.1–2.8）：全 repo grep 無殘留非 raw-source 語義的舊路徑；raw source 引用未被誤改
|
||
|
||
---
|
||
|
||
## Phase 3：版本、文件、提交
|
||
|
||
> 前置條件：Phase 1+2 完成、bash -n 過
|
||
|
||
- [x] 3.1 bump template/.claude/VERSION → 1.9.0（注意：VERSION 檔本身也要隨結構搬到 system-dev/，但發佈源 template 內的相對位置同步調整）
|
||
- [x] 3.2 CHANGELOG 記 1.9.0（結構重構 + 遷移行為）
|
||
- [x] 3.3 commit（先不 push，等實機驗證）
|
||
|
||
---
|
||
|
||
## Phase 4：實機 KB 套用與驗證
|
||
|
||
> 前置條件：Phase 1–3 完成；用戶點頭才動實機
|
||
|
||
- [ ] 4.1 KB：.claude/wiki/（含 192 卡 + .git）搬 system-dev/wiki/，保留 .git
|
||
- 驗收：192 張卡與 wiki/.git 完整，git log 不斷
|
||
- [ ] 4.2 KB：.claude/VERSION、根工具 docs 搬 system-dev/；用戶自有 docs 不動
|
||
- [ ] 4.3 KB：開 session 接關正常、/wiki-init 寫入 system-dev/wiki/cards/
|
||
- 驗收：hook 接關輸出正常、無防呆警告（表示已遷移完成）
|
||
|
||
---
|
||
|
||
## 完成定義
|
||
|
||
整個 SDD 完成 = 以下全部達成：
|
||
- [ ] 所有 tasks 標 [x]
|
||
- [ ] design.md 驗收標準全通過（有客觀證據）
|
||
- [ ] design.md 與實作一致
|
||
|
||
---
|
||
|
||
## 狀態說明
|
||
|
||
| 標記 | 意義 |
|
||
|------|------|
|
||
| `[ ]` | 未開始 |
|
||
| `[🔄]` | 進行中（當前 session）|
|
||
| `[x]` | 完成（有驗收證據）|
|
||
| `[~]` | 暫緩（說明原因）|
|
||
| `[!]` | 阻擋中（說明阻擋原因）|
|