feat(hooks): 新增部署後強制重啟閘門，接線與冒煙同步到八支 hook #35
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: plugins/hooks#35
Reference in New Issue
Block a user
PR 描述
摘要
restart-gate.sh把「還沒重啟就繼續用技能」擋在門外，並由session-timer.sh在判定為新工作階段時清除。決策紀錄在 wikiknowledges/QUESTION的QUESTION_FB8DF0B5（2026-08-27 兩節共 12 題）。本 PR 是主幹feat/skillset-governance/main併回develop的釋出 PR，內容為已合併的子功能 PR #33。變更內容
hooks/restart-gate.sh$JSC_HOME/restart-required存在時擋下 jsc 技能呼叫（exit 2），並提供require、clear、report三個子命令給工具端呼叫。狀態檔格式與判定全在這一支，是唯一真實來源hooks/session-timer.shstart與restart兩個子命令判定為新工作階段時轉呼叫restart-gate.sh clear。清除掛在這裡，因為新舊工作階段的判準只有這支腳本知道hooks/hooks.jsonPreToolUse的Skillmatcher 加上restart-gate.sh，排在version-guard.sh前面tools/wire-cli.shskills/hooks-install/SKILL.mddegraded的理由補上重啟閘門接不上，並寫明狀態檔照樣寫、照樣清，只是中間沒有判定點README.md、AGENTS.mdJSC_RESTART_GATE逃生門plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.jsonskills/hooks-install/SKILL.md（#34）jsc-ask:ask、jsc-git:pr、jsc-git:commit，並寫明閘門認技能名不認呼叫鏈。實作與準則在 #33 就已是九支，只有這份技能文件落後設計重點
at、mode、domains、cli），欄位只用在擋人訊息上；檔案存在就是還沒重啟過的證據。欄位缺了只讓訊息少幾個字，不影響判定。格式壓到最簡，是為了讓jsc-cli那端也對得上。jsc-cli:deploy、jsc-hooks:hooks-install、jsc-gitea:wiki、jsc-log:worklog、jsc-log:learn、jsc-meta:*），但豁免技能轉呼叫非豁免技能照樣被擋：deploy要問模式必須呼叫jsc-ask:ask、jsc-meta四支異動技能的收尾要開 PR 必須呼叫jsc-git:pr（而pr的第一步是jsc-git:commit）。使用者裁定補上這三支，共九支。version-guard.sh當年把jsc-ask:ask收進豁免，也是同一個原因。jsc-gitea:wiki與jsc-log。整批擋下去，「先重啟」與「先寫完報告」會互相打死，使用者兩件事都做不完。這正是同批加進jsc-meta稽核清單的流程檢查第 4 項要抓的東西。sessions/{sid}.start在不在）只有session-timer.sh知道，兩邊各寫一份就會漂移。所以清除由session-timer.sh的start與restart分支轉呼叫，續接同一階段（SessionStart 再觸發、resume、compact）不會走到那一段，閘門就一路留到真的重新啟動。version-guard.sh：狀態檔讀不到、技能名取不到、工具名不是Skill，三種都 exit 0。沒有證據時擋下等於停掉每一次技能呼叫。另外只管jsc-{domain}:{name}形式的技能，別人的技能不受影響。require寫不進去要出聲。 寫失敗回 exit 2 並印錯誤，因為沒寫成就沒有閘門，部署那端卻會以為掛上了。clear、report一律 exit 0，檔案不存在也算成功。require、clear、report都不讀 stdin，只有 hook 模式讀。理由與sdlc-gate.sh相同：標準輸入是管線又沒人關閉時read_stdin會一直等，工具端呼叫就整支卡死。工具端呼叫一律再補</dev/null。cli_bin，取不到就寫「目前的 CLI」。印別的 CLI 的執行檔名等於沒給指示。訊息同時列出九支仍可使用的技能與逃生門。JSC_RESTART_GATE=off完全略過整道閘門。測試結果
tools/ste100-lint.sh掃本存取庫全綠。plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）版本一致，皆為 0.2.4。hooks/restart-gate.sh的判定逐條實測，各自比對退出碼：狀態檔不存在放行、狀態檔存在時擋下jsc-sdlc:implement（exit 2）、九支豁免技能在狀態檔存在時全部放行、逃生門JSC_RESTART_GATE=off放行、取不到技能名放行。require寫出狀態檔後，以暫時的$JSC_HOME跑session-timer.sh start，狀態檔確實被清除。tools/wire-cli.sh smoke claude回status=ok，14 項判定路徑的退出碼與預期全部相同。冒煙用暫時目錄自備狀態檔，不會動到使用者真正的$JSC_HOME/restart-required。PreToolUse，沒有任何判定點，所以是「無法測試」而不是「還沒測試」。狀態檔照樣寫、下次工作階段開始照樣清，中間沒有守門，重啟只能靠jsc-cli:deploy收尾的提示由使用者自己動手。wire-cli.sh對這四支一律回報degraded並在reason講明，hooks-install的敘述也照這個說法回報，不暗示每個 CLI 都有保護。前置 Push Request
jsc-cli的tools/deploy.sh轉呼叫本存取庫的hooks/restart-gate.sh require，因此 cli 那支釋出 PR 依賴本 PR，本 PR 自己沒有前置。子功能 PR #33 已合併進主幹feat/skillset-governance/main，本 PR 只是把主幹併回develop，沒有未結清的前置 PR。What：新增第八支 hook `hooks/restart-gate.sh`。hook 模式在 `$JSC_HOME/restart-required` 存在時以 exit 2 擋下 jsc 技能呼叫，另有三個子命令：`require {模式} [{domain}...]` 寫入狀態檔掛上閘門、`clear` 清除狀態檔、`report` 印出狀態檔內容。`hooks/hooks.json` 把它接到 PreToolUse(Skill)，排在 `version-guard.sh` 前面。`hooks/session-timer.sh` 的 `start` 與 `restart` 在判定為新工作階段時轉呼叫 `clear`。 Why：部署換掉的是磁碟上的技能檔，正在跑的 CLI 行程載入的還是舊版——SKILL.md、hook 腳本與 tools 都在啟動當下讀進記憶體。這段落差期間跑技能，改動看起來沒生效，人會以為部署失敗又重跑一次。所以部署收尾要求重新啟動，這道閘門負責讓「還沒重啟就繼續用技能」擋在門外。 How：判定看的是「檔案在不在」，欄位只用在擋人訊息上——欄位缺了只讓訊息少幾個字，不影響判定。狀態檔用純文字 `key=value`（`at`、`mode`、`domains`、`cli`），格式與工作包狀態檔同一套，`jsc-hooks` 與 `jsc-cli` 兩邊各自實作也對得上。放行原則比照 `version-guard.sh`：只擋確定違規，狀態檔讀不到、技能名取不到、工具名不是 `Skill`、技能不是 `jsc-*:*` 一律 exit 0，沒有證據時擋下等於停掉每一次技能呼叫。九支豁免（`jsc-cli:deploy`、`jsc-hooks:hooks-install`、`jsc-gitea:wiki`、`jsc-log:worklog`、`jsc-log:learn`、`jsc-meta:*`、`jsc-ask:ask`、`jsc-git:pr`、`jsc-git:commit`）的理由是同一件事：部署後還要寫得完技能組異動報告與工作日誌，整批擋下去「先重啟」與「先寫完報告」會互相打死。後三支自己不是收尾規則的主體，是為了讓前六支走得完才補進來的——清單認的是技能名，不是呼叫鏈。清除交給 `session-timer.sh`，不由本檔自己判：新舊工作階段的判準（`sessions/{sid}.start` 在不在）只有那支腳本知道，兩邊各寫一份就會漂移；續接同一階段走不到那一段，閘門就一路留到真的重新啟動。`require`、`clear`、`report` 都不讀標準輸入，只有 hook 模式讀，工具端呼叫一律再補 `</dev/null`，理由與 `sdlc-gate.sh` 相同。接線排在 `version-guard.sh` 前面：還沒重啟的舊版比落後一個版號更該先攔。不認得的子命令一律安靜 exit 0，不中斷宿主 CLI。擋人訊息依實際 CLI 給重啟方式，並附上豁免清單與逃生門 `JSC_RESTART_GATE=off`。 Who：部署後的第一次技能呼叫，以及 `jsc-cli:deploy` 收尾寫入狀態檔的那一端。