feat(spec-version-guard): 新增版本前置檢查規範、腳本與 hook #9

2026-08-17T06:56:18Z

jiantw83 commented

2026-08-17 06:56:18 +00:00

摘要

新增 spec-version-guard 規範：定義「遠端發佈版本（Gitea master）vs 當前實際載入版本」的比對規則、fail-closed（查不到遠端一律阻擋）、統一錯誤訊息格式。
新增共用腳本 scripts/version-guard.mjs：hook／CLI 雙模式（hook 模式輸出 Claude Code／Copilot 相容的 PreToolUse deny JSON；CLI 模式用 exit code），已實測本地落後、本地相符、遠端不可達三種情境。
spec-preflight 載入順序補上版本檢查第 0 步，並區分「版本不符」與「shared 未安裝」兩種不同中斷訊息。
新增 hooks/hooks.json 掛 PreToolUse；do-wiki／models／plan-wiki／plugins-uninstall／todo-wiki 五個 skill 檔頭引用新規範（plugins-install 刻意排除，避免版本落後時擋住自己的修復手段）。
三家 manifest 升版至 0.2.1，並訂正 plugin.meta.json 版本落差（原 0.1.7，是三份 manifest 版本產生器實際讀取的來源）。

Test plan

version-guard.mjs 本地測試：0.1.4 vs 遠端 0.2.0 → 阻擋；0.2.0 vs 0.2.0 → 放行；host 不可達 → fail-closed。
hook 模式 stdout JSON（permissionDecision: deny/allow）手動驗證。
實際掛載到助理後的端到端驗證（同版放行／不同版阻擋／查不到遠端阻擋）留待合併發佈後於新 session 實測。

🤖 Generated with Claude Code

## 摘要 - 新增 `spec-version-guard` 規範：定義「遠端發佈版本（Gitea master）vs 當前實際載入版本」的比對規則、fail-closed（查不到遠端一律阻擋）、統一錯誤訊息格式。 - 新增共用腳本 `scripts/version-guard.mjs`：hook／CLI 雙模式（hook 模式輸出 Claude Code／Copilot 相容的 PreToolUse deny JSON；CLI 模式用 exit code），已實測本地落後、本地相符、遠端不可達三種情境。 - `spec-preflight` 載入順序補上版本檢查第 0 步，並區分「版本不符」與「shared 未安裝」兩種不同中斷訊息。 - 新增 `hooks/hooks.json` 掛 `PreToolUse`；`do-wiki`／`models`／`plan-wiki`／`plugins-uninstall`／`todo-wiki` 五個 skill 檔頭引用新規範（`plugins-install` 刻意排除，避免版本落後時擋住自己的修復手段）。 - 三家 manifest 升版至 `0.2.1`，並訂正 `plugin.meta.json` 版本落差（原 `0.1.7`，是三份 manifest 版本產生器實際讀取的來源）。 ## Test plan - [x] `version-guard.mjs` 本地測試：0.1.4 vs 遠端 0.2.0 → 阻擋；0.2.0 vs 0.2.0 → 放行；host 不可達 → fail-closed。 - [x] hook 模式 stdout JSON（`permissionDecision: deny/allow`）手動驗證。 - [ ] 實際掛載到助理後的端到端驗證（同版放行／不同版阻擋／查不到遠端阻擋）留待合併發佈後於新 session 實測。 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jiantw83 added 2 commits 2026-08-17 06:56:18 +00:00

feat(spec-version-guard): 新增版本前置檢查規範、共用腳本與 hook 2329e4d709

新增 spec-version-guard 規範（定義遠端發佈版本 vs 當前實際載入版本的比對規則、
fail-closed、錯誤訊息格式）與 scripts/version-guard.mjs（hook／CLI 雙模式，
hook 模式輸出 Claude Code/Copilot 相容的 PreToolUse deny JSON）；spec-preflight
的載入順序補上版本檢查第 0 步；新增 hooks/hooks.json 掛 PreToolUse；
do-wiki/models/plan-wiki/plugins-uninstall/todo-wiki 五個 skill 檔頭引用新規範
（plugins-install 刻意排除，避免版本落後時擋住自己的修復手段）。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

chore(plugin 版本): 三家 manifest 升版 0.2.1 1224fd8ab7

新增 spec-version-guard 規範／腳本／hook，對照 master 現行版本 0.2.0 升版；
一併訂正 plugin.meta.json 版本落差（原為 0.1.7，是三份 manifest 版本產生器
實際讀取的來源，放著不同步會在下次重新產生時把版本覆寫回舊版）。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

admin approved these changes 2026-08-17 06:57:11 +00:00

admin merged commit df2f177520 into master

2026-08-17 06:57:14 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/shared#9