Files
system-dev-template/template/profiles/orchestrator/docs/sprint.md.template
T
Leo 2f5d9f3bb2 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>
2026-08-06 00:26:56 +08:00

62 lines
2.3 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 標記,附**實測證據**
- 沒亮的站 → **搬移**到下一期,並寫一行「為什麼沒亮」
- 沒人認領也沒亮的任務 → **作廢或退回池子**,不准留在這裡假裝還活著
- 狀態只有三種:**✅ 通(附實測證據)/◐ 半通(標明缺什麼)/❌ 斷**
- 「程式碼寫完了」不是狀態