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>
2.4 KiB
2.4 KiB
政策包（policy pack）＝ 官方 plugin，以及它什麼時候被載入
這份是約定，不是實作。它回答一件事：機制是怎麼在 agent 醒來之前就已經在場的。
鐵律：政策包一律做成 Claude Code 官方 plugin
- 框架不發明平行的外掛格式。官方 plugin 已經涵蓋 hooks／skills／agents／commands／ MCP server 的打包、安裝與版本分發——自造一套等於重寫一個市場上活得好好的輪子。
- 要寫政策包的人，動手前先讀官方文件，照現行 schema 實作， 不要憑記憶寫設定檔格式。官方會改，記憶不會跟著改。
三層是什麼（別把層搞混，混了就回不去）
- 框架（L1）：方法論——雙軌、wiki、封路、階梯、儀表
- 判準：換一家公司照樣成立
- 住這裡：本 template
- 政策包（L2）：一家之言的技術棧政策
- 判準：換一家公司就不成立
- 住這裡：獨立的 plugin repo
- 實例（L3）：資料——卡片內容、wiki、sprint、指標
- 判準：換一個 repo 就不成立
- 住這裡：各實例自己
框架範本裡出現具體專案名 ＝ 格式錯誤（有 CI 擋）。政策包不受此限——專名是它的內容。
載入順序（agent 醒來時世界已就位）
- profile 憲法（scope 軸：這個資料夾的 CLAUDE.md——總管版或成員版）
- 框架 hooks 上鏈（common ＋ profile）
- 已安裝的政策包注入——必讀推到眼前、白名單 hook 排入鏈尾、skill 就緒
- 接關（wiki 快照）
- 執行期的總管／engineer 不需要知道 plugin 是官方機制還是框架機制—— hooks 在鏈上就會攔、skill 在庫裡就會觸發。
- 機制不靠認知，靠結構在場。 唯一需要懂 plugin 規格的角色，是「改框架／寫政策包的人」。
框架這一側只做兩件事
- 文件化上面這個約定與順序（就是這份檔）
- 在兩部憲法裡留 must-read 注入點——政策包的 SessionStart hook 有地方把必讀推進來
注入點長這樣（兩部憲法末尾都有）：
## 政策包必讀（policy pack must-read）
<!-- policy-pack:must-read -->
- 沒裝政策包時它是空的，不影響任何事。
- 框架不需要為此新造機制——官方 hook 就做得到。