fix/version-guard-exempt-ask-and-wiki #25

2026-08-26T10:40:50Z

jiantw83 commented

2026-08-26 10:40:50 +00:00

摘要

需求描述：版本守門 hook 擋下 jsc-ask:ask 與 jsc-gitea:wiki，讓 jsc-cli:deploy 問不到部署模式就卡住。本 PR 把這兩支加進豁免清單解開死鎖，並把 jsc-hooks:hooks-install 產生的本機接線檔目錄 .kiro/ 加進 .gitignore。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
hooks/version-guard.sh	豁免清單加入 `jsc-ask:ask` 與 `jsc-gitea:wiki`。deploy 一定先呼叫 ask 問模式，ask 又一定寫回 wiki 才算完成。這兩支被擋，deploy 就做不完，等同死鎖。檔頭註解同步補上兩條理由。
.gitignore	新增 `.kiro/`。該目錄是 `jsc-hooks:hooks-install` 在本機產生的接線檔，內容含本機絕對路徑，提交進來會讓別人拉到錯的路徑，也會每次接線就冒出雜訊變更。

設計重點

豁免理由一致：只豁免「deploy 流程自己會呼叫、擋了就形成死鎖」的技能，不放寬其他技能。
只改比對樣式，不動 exit 0 的略過行為，行為面維持原設計。
檔頭註解與程式碼同步更新，後人看註解就知道每一條豁免的成因。
.kiro/ 只忽略不刪檔，本機既有目錄原地保留。
本 PR 不動任何 manifest 版本。此存取庫後續另有 PR 統一 bump，先 bump 會造成版本衝突。

測試結果

sh -n hooks/version-guard.sh：結束碼 0，語法檢查通過。
git status --porcelain：加入 .kiro/ 後不再列出該目錄，確認忽略規則生效。

前置 Push Request

無

## 摘要 - 需求描述：版本守門 hook 擋下 `jsc-ask:ask` 與 `jsc-gitea:wiki`，讓 `jsc-cli:deploy` 問不到部署模式就卡住。本 PR 把這兩支加進豁免清單解開死鎖，並把 `jsc-hooks:hooks-install` 產生的本機接線檔目錄 `.kiro/` 加進 `.gitignore`。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | hooks/version-guard.sh | 豁免清單加入 `jsc-ask:ask` 與 `jsc-gitea:wiki`。deploy 一定先呼叫 ask 問模式，ask 又一定寫回 wiki 才算完成。這兩支被擋，deploy 就做不完，等同死鎖。檔頭註解同步補上兩條理由。 | | .gitignore | 新增 `.kiro/`。該目錄是 `jsc-hooks:hooks-install` 在本機產生的接線檔，內容含本機絕對路徑，提交進來會讓別人拉到錯的路徑，也會每次接線就冒出雜訊變更。 | ## 設計重點 - 豁免理由一致：只豁免「deploy 流程自己會呼叫、擋了就形成死鎖」的技能，不放寬其他技能。 - 只改比對樣式，不動 `exit 0` 的略過行為，行為面維持原設計。 - 檔頭註解與程式碼同步更新，後人看註解就知道每一條豁免的成因。 - `.kiro/` 只忽略不刪檔，本機既有目錄原地保留。 - 本 PR 不動任何 manifest 版本。此存取庫後續另有 PR 統一 bump，先 bump 會造成版本衝突。 ## 測試結果 - `sh -n hooks/version-guard.sh`：結束碼 0，語法檢查通過。 - `git status --porcelain`：加入 `.kiro/` 後不再列出該目錄，確認忽略規則生效。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-26 10:40:50 +00:00

fix(version-guard): 把 jsc-ask:ask 與 jsc-gitea:wiki 加進豁免清單 0c83495ba8

What：版本守門 hook 的豁免清單新增 jsc-ask:ask 與 jsc-gitea:wiki 兩支技能，並在檔頭註解補上理由。

Why：jsc-cli:deploy 要問使用者 install/update/uninstall，一定會呼叫 jsc-ask:ask；ask 問完又一定寫回 wiki 才算完成。這兩支只要版本落後就被擋下，訊息還指回 /jsc-cli:deploy，deploy 卡在問不出模式那一步，形成死鎖，跟直接擋 deploy 是同一種問題。

How：在 case "$skill" 的豁免比對加上 jsc-ask:ask 與 jsc-gitea:wiki 兩個樣式，維持原本 exit 0 的略過行為；檔頭豁免清單註解同步補上兩條說明，講清楚死鎖成因。

Who：hooks/version-guard.sh 的外掛版本守門功能，影響 jsc-cli:deploy 的部署流程。

chore(gitignore): 忽略本機接線檔目錄 .kiro/ 961af918bf

What：在 .gitignore 的暫存分類底下新增 .kiro/ 一行，讓該目錄維持不追蹤。

Why：.kiro/ 是 jsc-hooks:hooks-install 在本機產生的接線檔，內容含本機絕對路徑。這種檔案因人而異，提交進存取庫會讓別人拉到錯的路徑，也會每次接線就冒出雜訊變更。

How：於 .gitignore 加上獨立註解區塊與 .kiro/ 樣式，只忽略不刪檔；本機既有目錄原地保留，git status 不再列出。

Who：hooks 存取庫的版本控管設定，配合 jsc-hooks:hooks-install 的接線產出。

admin merged commit a4996064ff into develop

2026-08-27 00:56:36 +00:00

admin deleted branch fix/version-guard-exempt-ask-and-wiki

2026-08-27 00:56:36 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/hooks#25