feat(W2 Phase 2-3): JDD 文件範本+八條封路 hook+還清兩件舊債

SDD: docs/3-specs/jdd-dual-profile(active)。編號 task 26/33 完成,Phase 4-5 未開工。

■ Phase 2 JDD 文件範本(orchestrator profile)
範本形狀對齊「實際跑出來的那兩份」(總管已寫的 root.md 15 卡、journeys.md J-1 九站),
不是照規格憑空造:
- 卡片是巢狀 bullet(`- **P1** 🟢 …` + 子項放來源/對帳),非規格畫的平行文字行
- 站點索引**巢狀 bullet 不用表格**(表格會把層級壓平,看不出從屬)
- 兩份都保留「這卷還缺什麼(誠實記)」收尾段——規格沒有,但那是防假綠的地方
新增:root.md / journeys.md / sprint.md / triage-map.md 四範本(add-if-missing,
填了就永不覆蓋)+ plugin-load-order.md(W3 插槽,框架不發明平行外掛格式)

■ Phase 3 封路 hook(八條規則落六支檔)
- role-guard(J1+J2+J3)★命門:考生不能改考卷。六組實測含「考題藏在別的 md 裡」也擋
- jdd-format-guard(J4+J5+J8):紅卡缺對帳日/任務缺站號/PM 文件混技術名詞
- station-done-guard(J6):收工判準是站的考題全綠,不是任務全關
- regression-scope(J7):動實作 → 列出要重考哪幾題(只提醒不擋)
- install-artifact-guard(S1):實例不改機制
- orchestrator-scope-guard(S4):總管不進成員 repo 動實作(從實例上收進框架,
  路徑清單改由實例自填,範本零專名)
掛載鏈依「範圍大的擋在前」:改機制 → 角色 → 位置 → 格式 → 既有三支

■ 還清兩件舊債
- update.sh 檔案清單改讀 manifest(舊硬編降為抓不到來源時的 fallback)
  ——install/update 兩份手抄清單漂移的根因全修
- CLAUDE.md 界標補植:舊實例全文原封包進本地區、框架區重鋪、原檔備份、冪等
  ——解開「沒界標⇒不敢覆蓋⇒框架改的憲法永遠送不到既有實例」這個死結

■ 修掉三個自己造的問題(實測抓出來的,不是想出來的)
- jdd-format-guard 誤擋真實 journeys.md 的「這卷還缺什麼」自述段
  → 排除法改**正面圈定**(只掃卡片本體與站內文),說明區/自述段/索引自然不在範圍
- install-artifact-guard 把 pre-write-guard.sh 也擋了——而它的錯誤訊息正叫人去改那支
  → 使用者自訂插槽列為最優先放行
- check-legacy-paths 用 HEAD 當基準會**自我弱化**:改成清單驅動後保護範圍 35→29 條
  → 基準改指最後一次真正發佈的版本

■ 實測(全部貼過輸出)
- G2 考生改考卷:6/6,含 orchestrator 寫 code/engineer 改考題/考題藏別處
- G4 憲法分流:兩環境重裝,總管版技術軌關鍵字 0、成員版上游指針 8,界標 4/4
- G6 實例改機制:4/4,含框架開發標記放行與自訂插槽放行
- G7 CI 擋實例名:注入違規 → 指出檔案行號 exit 1
- G3 進度以站計量:起牀推「J-1 已點亮 2/9 站」、收工列未亮站並禁用任務數當理由
- 回歸考、界標補植冪等、orchestrator-scope-guard 四組:全通

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-06 00:26:56 +08:00
parent 6a49f25aef
commit 2f5d9f3bb2
18 changed files with 1246 additions and 83 deletions
@@ -0,0 +1,61 @@
# sprint.md — 本期要點亮哪幾站
> **單位是站號,不是一批任務。** 這份檔的存在理由:讓自動起牀的排程/新開的 session
> 一睜眼就有明確的「離通關還缺什麼」,而不是讀到一堆過期任務只能空轉收工。
> **誰能寫**:只有總管(orchestrator)。
---
## 本期
- **期間**[YYYY-MM-DD] → [YYYY-MM-DD]
- **交付**[J-x] 的 **[S-a]、[S-b]**
- **考題**G-a.1、G-a.2、G-b.1
- **這期不做**:[明寫哪些站這期不碰。沒寫,別人就會自己加戲。]
### 現在幾站亮了
- [J-x] 已點亮 **n/m** 站
- ✅ 已亮:[S-?]([實測證據在哪])
- ◐ 半通:[S-?]([缺什麼])
- ❌ 未亮:[S-?]、[S-?]
---
## 認領流程(順序鐵律,不准跳)
> **先認領 → 認領不足才新增 → 新增必掛站。** 這個順序是為了防止重造一份任務清單。
1. **先認領**:對現有任務池**逐項**問——
「這個任務不做,[S-a]/[S-b] 的考題會掛嗎?」
- 會掛 → 認領進本期
- 不會 → **留在池子裡,這期不准碰**
2. **認領完考題還是過不了** → 池子真的缺東西 → **此時才准新增任務**
- 新任務**必須標注它服務哪一站**(無站號=格式錯誤,hook 會擋)
3. **收尾判準**=指定站的考題**全綠**,不是任務全關
- 🟢 站 → 點亮、關閉
- 🔴 站 → 點亮 + 轉「對帳中」,等 root.md 上的對帳日
---
## 認領清單
- [S-a] [站名]
- 認領:[任務編號/描述](在哪個 repo)
- 認領:[...]
- 新增:[...] ← 標明是新增的,以及為什麼池子裡沒有
- [S-b] [站名]
- 認領:[...]
---
## 到期結算(換檔機制)
> 期間一到就**強制結算**,不准無聲延期——過期的 sprint 檔正是「起牀讀到殘骸」的來源。
- 到期日 [YYYY-MM-DD] 當天做三件事:
- 亮了的站 → 在 journeys.md 標記,附**實測證據**
- 沒亮的站 → **搬移**到下一期,並寫一行「為什麼沒亮」
- 沒人認領也沒亮的任務 → **作廢或退回池子**,不准留在這裡假裝還活著
- 狀態只有三種:**✅ 通(附實測證據)/◐ 半通(標明缺什麼)/❌ 斷**
- 「程式碼寫完了」不是狀態