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>
3.4 KiB
3.4 KiB
wiki-architecture — Tasks
權威來源:此檔案是進度真相。動手前標 [🔄],完成立刻標 [x]。
Phase 0:審核(前置)
- 0.1 design.md 經用戶審核通過(push/pull 判準、push 三項形態、INDEX 多角度)
Phase 1:規則文件(wiki-init + SKILL)
前置:Phase 0
- 1.1 wiki-init.md 寫入 push/pull 判準 + 三類 push(status全文/principles全文/mistakes摘要)
- 驗收:CC 讀 wiki-init 能判斷一個內容該 push 還 pull
- 1.2 wiki-init.md 新增 principles 檔的建立與維護規則(一行一條、條數上限)
- 1.3 wiki-init.md decisions-summary 重定位為「pull / INDEX 決策視圖」,既有內容相容
- 1.4 SKILL.md(Cowork)同步上述規則,CC/Cowork 一致
- 驗收:兩來源檔 push/pull 規則 byte 對齊(除路徑)
Phase 2:INDEX 升級為多角度視圖
前置:Phase 1
- 2.1 INDEX.md 範本:從「標籤視圖」升級為「多角度入口」(標籤/決策/原則…角度)
- 2.2 明示「新增角度 = 改 INDEX 一節,不開新檔、不問用戶」
- 2.3 principles/mistakes 在 INDEX 留 pull 指標
- 驗收:INDEX 範本含多角度說明 + 新增角度的自助規則
Phase 3:push 機制(session-start hook)
前置:Phase 1
- 3.1 session-start-recall.sh 擴充:注入 status 全文 + principles 全文 + mistakes 標題清單
- 3.2 context 保護:principles 條數上限檢查、mistakes 只注入標題+一行
- 3.3 bash -n + 沙盒測試(三類都有時注入正確、量受控)
- 驗收:開 session 三類都被動出現,總量有節制
Phase 4:新增 principles 範本 + 種子原則
前置:Phase 1-3
- 4.1 建 template/system-dev/wiki/principles.md 範本
- 4.2 install.sh download + update.sh keep_file(用戶資料,永不覆蓋)
- 4.3 種子原則寫入(dev repo 自用 wiki):不污染用戶根目錄、目標用戶 low-code、wiki 主要給 AI 看、內部文件不推
- 驗收:開 session 這些原則被動出現在 context
Phase 5:版本、文件、提交
- 5.1 bump(中版號,新增 principles 功能)+ 兩 VERSION 同步
- 5.2 CHANGELOG
- 5.3 commit + push(已隨 1.10.0~1.11.0 推送)
完成定義
- 所有 tasks [x]
- design.md 驗收標準全過
- 實證:CC 開 session 會被動看見 principles(本 session SessionStart hook 已注入 9 條,成立)
下游驗收(2026-06-26,KB 端 183 卡實跑壓測)
採集規範升級(gloss /
## 實體/ typed-edge / 端點對齊護欄)首次真實 ingest 全量驗證,全綠:
| 驗收項 | 結果 |
|---|---|
| 結構齊全(gloss + 實體 + 兩層各 1 份) | ✅ 183/183 |
| 有 gloss | ✅ 183/183 |
| 內文三元組總數 | 1,029 條 |
| 端點對不齊 / 三段式 | ✅ 0 |
| raw source 鐵律(pages/journals 0 異動) | ✅ |
| 內文層無誤用 wikilink | ✅ 乾淨 |
- 放量分三批、驗收驅動:試跑 12 → 補硬自檢 → 0;放量 170 → 殘留 26 → 修正批 15 → 殘留 1 → 手修;全量 0 缺陷。
- 印證 issue #11 的「端點硬自檢」護欄(Haiku 量產 14→0)在真實規模成立。
- 連帶修了 KB 端 CLAUDE.md 6 處過時路徑(
.claude/wiki/→system-dev/wiki/),即 1.9.3 hook 提示的場景。
狀態:結案。 採集規範 / push 機制 / ## 實體 都已下游實證,無待驗證項。