2f5d9f3bb2
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>
55 lines
2.6 KiB
Bash
55 lines
2.6 KiB
Bash
#!/bin/bash
|
||
# regression-scope.sh — 動到某一站的東西 → 告訴你要重考哪些題(JDD 規則 J7)
|
||
#
|
||
# 掛 PostToolUse(Write|Edit|MultiEdit)。**只提醒,不阻擋**(exit 0)。
|
||
#
|
||
# ── 為什麼只提醒 ────────────────────────────────
|
||
# 重考範圍是判斷題不是是非題——擋下來只會讓人為了繼續工作而亂填。
|
||
# 它要消滅的失敗模式只有一個:**改完東西,忘了它會弄壞哪幾站**。
|
||
# (「S3 安裝流程變了 → 後面 S4~S9 全部要重考」這種事,
|
||
# 不查索引表沒有人會自己想到。)
|
||
#
|
||
# ── 判斷「動到哪一站」怎麼做 ─────────────────────
|
||
# 靠 journeys.md 的**站點索引**。索引裡若有登記關聯路徑就用它;
|
||
# 沒有登記時退回一個誠實的作法:只要動到 code,就把索引整份摘要推一次,
|
||
# 讓人自己對——**不猜**。猜錯的重考範圍比沒有更危險(會讓人以為已經涵蓋了)。
|
||
|
||
set -uo pipefail
|
||
|
||
HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||
. "$HOOK_DIR/lib/role-lib.sh" 2>/dev/null || exit 0
|
||
|
||
INPUT="$(cat)"
|
||
FILE_PATH="$(sdt_file_path "$INPUT")"
|
||
[ -z "$FILE_PATH" ] && exit 0
|
||
REL="$(sdt_rel_path "$FILE_PATH")"
|
||
|
||
# 只對「實作變動」出聲;改文件不必每次都喊
|
||
case "$REL" in
|
||
src/*|*/src/*|*.py|*.ts|*.tsx|*.js|*.go|*.rs|*.sh|*.java|*.rb|*.vue|*.svelte) ;;
|
||
*) exit 0 ;;
|
||
esac
|
||
|
||
ROOT="$(sdt_repo_root)"
|
||
JOURNEYS=""
|
||
for cand in "$ROOT/system-dev/docs/journeys.md" "$ROOT/../system-dev/docs/journeys.md"; do
|
||
[ -f "$cand" ] && JOURNEYS="$cand" && break
|
||
done
|
||
[ -z "$JOURNEYS" ] && exit 0 # 沒有 PM 軌文件(多數成員 repo)→ 安靜
|
||
|
||
# 取站點索引段(「附:站點索引」以下)
|
||
INDEX="$(awk '/^##[[:space:]]*附.*站點索引/{f=1} f' "$JOURNEYS" 2>/dev/null | head -60)"
|
||
[ -z "$INDEX" ] && exit 0
|
||
|
||
echo "════════════════════════════════════════════════"
|
||
echo "🔁 回歸考提醒(J7):你動了實作,查一下要重考哪幾題"
|
||
echo "════════════════════════════════════════════════"
|
||
echo " 剛動的:$REL"
|
||
echo ""
|
||
printf '%s\n' "$INDEX" | sed 's/^/ /'
|
||
echo ""
|
||
echo " ⚠️ 這份索引是「站 → 被哪些旅程經過 → 改動時重考什麼」。"
|
||
echo " 對照你剛改的東西屬於哪一站,把**下游**也一起重考——"
|
||
echo " 安裝那類的站一變,後面全部都要重來。"
|
||
exit 0
|