Leo
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>
116 lines
6.9 KiB
Bash
Executable File
116 lines
6.9 KiB
Bash
Executable File
#!/bin/bash
|
||
# SessionStart hook — 開 session 自動注入 status.md 重點
|
||
# wishlist §1 主路徑：不靠 CC 自覺、不用人說，開 session 就把進度推到眼前。
|
||
#
|
||
# 掛在 settings.json 的 SessionStart（matcher: startup|resume|clear）。
|
||
# stdout 會被當成 context 注入給 CC。
|
||
#
|
||
# 鐵律：status 是 point-in-time 快照，非即時狀態。
|
||
# 這個 hook 只負責「把快照推到眼前」，核實快照是 CC 的責任——下面的提醒就是要它別盲信。
|
||
|
||
set -euo pipefail
|
||
|
||
STATUS_FILE="system-dev/wiki/status.md"
|
||
PRINCIPLES_FILE="system-dev/wiki/principles.md"
|
||
MISTAKES_FILE="system-dev/wiki/mistakes.md"
|
||
|
||
# ── 舊結構防呆（1.9.0 遷移第 2 層保險）──
|
||
# 新版 wiki 收進 system-dev/。若偵測到舊位置 .claude/wiki/ 還在、但新位置沒 status，
|
||
# 代表使用者升級了規則卻沒跑遷移（low-code 使用者常見）→ 出聲提示，讓 CC 當場可代為遷移，
|
||
# 不要默默用不到新結構而出錯。
|
||
if [ -d ".claude/wiki" ] && [ ! -f "$STATUS_FILE" ]; then
|
||
echo "⚠️ 偵測到舊版 wiki 結構（.claude/wiki/），尚未遷移到 system-dev/wiki/。"
|
||
echo " 請跑：bash system-dev/scripts/update.sh"
|
||
echo " 或直接叫我（CC）：「幫我把 wiki 遷移到 system-dev/」——我可以代為搬移。"
|
||
echo " （未遷移時接關與 /wiki-init 會找錯位置。）"
|
||
exit 0
|
||
fi
|
||
|
||
# ── profile 分流（1.19.0）：總管起牀先看「還缺哪幾站」──────────
|
||
# 為什麼加這段：自動起牀的排程／新 session 最常見的失敗模式是
|
||
# 「醒來讀到一堆過期任務，只能空轉收工」。治它的不是更勤勞的提醒，
|
||
# 是**讓它一睜眼就有明確的『離通關還缺什麼』**——那就是本期指定站。
|
||
# 成員 repo 不需要這段（它的工作單位是任務不是站），維持原行為。
|
||
SDT_PROFILE="repo"
|
||
[ -f "system-dev/.profile" ] && SDT_PROFILE="$(tr -d '[:space:]' < system-dev/.profile 2>/dev/null || echo repo)"
|
||
|
||
if [ "$SDT_PROFILE" = "orchestrator" ] && [ -f "system-dev/docs/sprint.md" ]; then
|
||
echo "════════════════════════════════════════════════"
|
||
echo "🎯 本期要點亮哪幾站（進度語言＝站，不是任務數）"
|
||
echo "════════════════════════════════════════════════"
|
||
# 期間、交付、現在幾站亮了——只取前 25 行，不整份灌
|
||
sed -n '/^## 本期/,/^## 認領流程/p' system-dev/docs/sprint.md 2>/dev/null \
|
||
| grep -vE '^## 認領流程' | head -25
|
||
echo ""
|
||
echo "📌 回報形式：「J-x 已點亮 n/m 站」。狀態只有 ✅ 通（附實測證據）／◐ 半通／❌ 斷。"
|
||
echo " 「程式碼寫完了」不是狀態。"
|
||
echo ""
|
||
if [ -f "system-dev/docs/root.md" ]; then
|
||
DUE="$(grep -oE '對帳日[^｜】]*' system-dev/docs/root.md 2>/dev/null | head -3)"
|
||
if [ -n "$DUE" ]; then
|
||
echo "🔴 紅卡對帳日（到期要拿真實數據判決：承諾成立，或換一個承諾）："
|
||
printf '%s\n' "$DUE" | sed 's/^/ /'
|
||
echo ""
|
||
fi
|
||
fi
|
||
fi
|
||
|
||
# 三個 push 檔都沒有 → 安靜退出，不干擾還沒 /wiki-init 的專案
|
||
if [ ! -f "$STATUS_FILE" ] && [ ! -f "$PRINCIPLES_FILE" ] && [ ! -f "$MISTAKES_FILE" ]; then
|
||
exit 0
|
||
fi
|
||
|
||
# ── push 1/3：principles（全文，行動前必服從）──
|
||
# 放最前：原則是「會被遺忘的盲區」，要第一眼看見。全文成本低（一行一條、≤15 條）。
|
||
if [ -f "$PRINCIPLES_FILE" ] && grep -q '^- ' "$PRINCIPLES_FILE" 2>/dev/null; then
|
||
echo "════════════════════════════════════════════════"
|
||
echo "📐 設計原則（行動前必服從，來自 principles.md）"
|
||
echo "════════════════════════════════════════════════"
|
||
grep '^- ' "$PRINCIPLES_FILE" # 只注入原則條目本身，不含說明區
|
||
# context 保護：原則應 ≤15 條（push 全文）。超過 → 提示該合併或下放成 card，不截斷（截斷會漏原則）。
|
||
P_COUNT=$(grep -c '^- ' "$PRINCIPLES_FILE")
|
||
if [ "$P_COUNT" -gt 15 ]; then
|
||
echo ""
|
||
echo "（⚠️ principles 已 ${P_COUNT} 條 > 15：請考慮合併相近原則、或把較細的下放成 card）"
|
||
fi
|
||
echo ""
|
||
fi
|
||
|
||
# ── push 2/3：status（全文，當前進度）──
|
||
if [ -f "$STATUS_FILE" ]; then
|
||
echo "════════════════════════════════════════════════"
|
||
echo "📍 接關：上次進度（來自 $STATUS_FILE 快照）"
|
||
echo "════════════════════════════════════════════════"
|
||
echo ""
|
||
cat "$STATUS_FILE"
|
||
fi
|
||
|
||
# ── push 3/3：mistakes（標題清單 + 一行症狀，全文按需展開）──
|
||
# 不全文注入（可能累積很多、含長 context）。只給「標題行」讓 CC 認出「我正撞到某條」→ 再去讀全文。
|
||
if [ -f "$MISTAKES_FILE" ] && grep -q 'MISTAKE' "$MISTAKES_FILE" 2>/dev/null; then
|
||
echo ""
|
||
echo "────────────────────────────────────────────────"
|
||
echo "⚠️ 已知踩坑（標題；撞到時讀 $MISTAKES_FILE 全文）"
|
||
grep -E 'MISTAKE' "$MISTAKES_FILE" | sed 's/^/ /'
|
||
fi
|
||
|
||
echo ""
|
||
echo "────────────────────────────────────────────────"
|
||
echo "⚠️ 以上是 point-in-time 快照，非即時狀態。"
|
||
echo " 動手前先核實：快照寫的事項是否真的還沒做完？"
|
||
echo " 需要完整脈絡（decisions / mistakes / SDD）→ 執行 /wiki-recall"
|
||
echo "════════════════════════════════════════════════"
|
||
|
||
# ── 遷移殘留偵測（1.9.x）：wiki 已搬到 system-dev/，但 CLAUDE.md 內容裡可能還寫舊路徑 ──
|
||
# update.sh 鐵則「絕不碰 CLAUDE.md」（用戶資料），所以遷移不會自動改它內容裡的死引用。
|
||
# 這裡只「偵測 + 提示 CC 代修」——由 CC（看得懂語義、不誤傷用戶自寫內容）來改，不讓腳本盲改。
|
||
if [ -f "CLAUDE.md" ] && grep -q '\.claude/wiki' CLAUDE.md 2>/dev/null; then
|
||
echo ""
|
||
echo "🔧 偵測到 CLAUDE.md 內仍有舊路徑 \`.claude/wiki/\`（wiki 已遷移到 system-dev/wiki/）。"
|
||
echo " 這些是遷移後的死引用，會讓你（CC）找錯位置。"
|
||
echo " 請主動幫使用者把 CLAUDE.md 裡的 \`.claude/wiki/\` 改成 \`system-dev/wiki/\`、"
|
||
echo " 工具 docs 路徑改成 \`system-dev/docs/\`（但 raw source 宣告的 \`docs/\` 保留不動）。"
|
||
fi
|
||
|
||
exit 0
|