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>
84 lines
3.4 KiB
Markdown
84 lines
3.4 KiB
Markdown
# wiki-architecture — Tasks
|
||
|
||
> 權威來源：此檔案是進度真相。動手前標 [🔄]，完成立刻標 [x]。
|
||
|
||
---
|
||
|
||
## Phase 0：審核（前置）
|
||
|
||
- [x] 0.1 design.md 經用戶審核通過（push/pull 判準、push 三項形態、INDEX 多角度）
|
||
|
||
---
|
||
|
||
## Phase 1：規則文件（wiki-init + SKILL）
|
||
|
||
> 前置：Phase 0
|
||
|
||
- [x] 1.1 wiki-init.md 寫入 push/pull 判準 + 三類 push（status全文/principles全文/mistakes摘要）
|
||
- 驗收：CC 讀 wiki-init 能判斷一個內容該 push 還 pull
|
||
- [x] 1.2 wiki-init.md 新增 principles 檔的建立與維護規則（一行一條、條數上限）
|
||
- [x] 1.3 wiki-init.md decisions-summary 重定位為「pull / INDEX 決策視圖」，既有內容相容
|
||
- [x] 1.4 SKILL.md（Cowork）同步上述規則，CC/Cowork 一致
|
||
- 驗收：兩來源檔 push/pull 規則 byte 對齊（除路徑）
|
||
|
||
## Phase 2：INDEX 升級為多角度視圖
|
||
|
||
> 前置：Phase 1
|
||
|
||
- [x] 2.1 INDEX.md 範本：從「標籤視圖」升級為「多角度入口」（標籤/決策/原則…角度）
|
||
- [x] 2.2 明示「新增角度 = 改 INDEX 一節，不開新檔、不問用戶」
|
||
- [x] 2.3 principles/mistakes 在 INDEX 留 pull 指標
|
||
- 驗收：INDEX 範本含多角度說明 + 新增角度的自助規則
|
||
|
||
## Phase 3：push 機制（session-start hook）
|
||
|
||
> 前置：Phase 1
|
||
|
||
- [x] 3.1 session-start-recall.sh 擴充：注入 status 全文 + principles 全文 + mistakes 標題清單
|
||
- [x] 3.2 context 保護：principles 條數上限檢查、mistakes 只注入標題+一行
|
||
- [x] 3.3 bash -n + 沙盒測試（三類都有時注入正確、量受控）
|
||
- 驗收：開 session 三類都被動出現，總量有節制
|
||
|
||
## Phase 4：新增 principles 範本 + 種子原則
|
||
|
||
> 前置：Phase 1-3
|
||
|
||
- [x] 4.1 建 template/system-dev/wiki/principles.md 範本
|
||
- [x] 4.2 install.sh download + update.sh keep_file（用戶資料，永不覆蓋）
|
||
- [x] 4.3 種子原則寫入（dev repo 自用 wiki）：不污染用戶根目錄、目標用戶 low-code、wiki 主要給 AI 看、內部文件不推
|
||
- 驗收：開 session 這些原則被動出現在 context
|
||
|
||
## Phase 5：版本、文件、提交
|
||
|
||
- [x] 5.1 bump（中版號，新增 principles 功能）+ 兩 VERSION 同步
|
||
- [x] 5.2 CHANGELOG
|
||
- [x] 5.3 commit + push（已隨 1.10.0~1.11.0 推送）
|
||
|
||
---
|
||
|
||
## 完成定義
|
||
- [x] 所有 tasks [x]
|
||
- [x] design.md 驗收標準全過
|
||
- [x] 實證：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 機制 / `## 實體` 都已下游實證，無待驗證項。
|