Files
system-dev-template/docs/3-specs/wiki-architecture/tasks.md
T
Leo 2a8c259d08 依 D22 翻正舊 ignore 政策:本 repo 自己的 SDD 進版控 + 新增 jdd-dual-profile 卷
🔴 修的病:這個框架 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>
2026-08-05 23:22:14 +08:00

3.4 KiB
Raw Blame History

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 判準 + 三類 pushstatus全文/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.mdCowork)同步上述規則,CC/Cowork 一致
    • 驗收:兩來源檔 push/pull 規則 byte 對齊(除路徑)

Phase 2INDEX 升級為多角度視圖

前置:Phase 1

  • 2.1 INDEX.md 範本:從「標籤視圖」升級為「多角度入口」(標籤/決策/原則…角度)
  • 2.2 明示「新增角度 = 改 INDEX 一節,不開新檔、不問用戶」
  • 2.3 principles/mistakes 在 INDEX 留 pull 指標
    • 驗收:INDEX 範本含多角度說明 + 新增角度的自助規則

Phase 3push 機制(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-26KB 端 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 機制 / ## 實體 都已下游實證,無待驗證項。