jiantw83
04225a7a2d
共用函式庫與各支腳本的檔頭各補一段結束碼宣告，逐個子命令寫明哪些情況放行、 哪些情況擋下。說明文件改寫成九支 hook 的現況，補上寫入與提交閘門、唯讀模式、 建議子命令與新的環境變數。異常目錄範本補上「一律附加、不整頁覆蓋」的寫入語意。 呼叫端要靠結束碼決定下一步，但多數腳本只寫用法、沒寫結束碼， 讀的人得自己翻程式碼推，推錯就把安靜降級當成失敗處理。 共用函式庫載不到時，殼層會就地結束並回非零，接在工具呼叫前的閘門遇到這一下 等於無聲擋人，腳本自己的放行路徑一條都跑不到，這件事非寫進每一支檔頭不可。 文件停在八支 hook 的舊敘述，看的人會誤判覆蓋範圍，以為每支 CLI 都擋得住。 目錄頁的寫入語意只寫在腳本裡，換一支工具來寫就會整頁覆蓋。 一支腳本一段檔頭，逐子命令列出結束碼，並各自註明共用函式庫載入失敗會回哪一個碼。 文件的行數一律引用腳本自己印出來的那一行，不另抄一份數字， 判定路徑增減時就不會漂移。覆蓋範圍逐支 CLI 分開寫，接不上的就寫接不上。
2.9 KiB
2.9 KiB
jsc-hooks — 給 AI 助理的指引
本 repo 是 jsc 技能組的 hooks domain（跨 CLI hooks：STE100 語言強制、工時計時、技能用量記錄、SDLC 模型鎖、版本前置檢查、部署後強制重啟閘門、註解範圍檢查、繁中與編碼檢查、寫入與提交閘門），可同時被 Claude Code / Codex / Copilot / Antigravity / Kiro 使用。
規則
- 所有交談與輸出內容使用 STE100 繁體中文，帶擬人台灣感：短句、一句一指令、台灣用語、全形標點、去 AI 味、直接講重點。完整規則的唯一來源：
plugins/meta的references/ste100.md。 - 技能位於
skills/{name}/SKILL.md；處理任務前先比對需求與各技能的description，相符就載入並依其步驟執行。 - 技能準則的唯一來源：
plugins/meta存取庫的references/guidelines.md。 - 所有 hook 只放在
jsc-hooks；gitea 操作一律經由jsc-gitea的tools/gitea.sh；問使用者一律依jsc-ask:ask的決策樹規則。 - 註解範圍規則正文的唯一來源：
jsc-review的references/comment-scope.md。本存取庫只放hooks/comment-scope.sh的判定實作，不留規則清單副本，接線腳本要用規則文字時一律取腳本的實際輸出。comment-scope.sh有prompt、無參數逐檔掃描、sweep掃整個 git 工作區三種模式；掃描時機每個 CLI 都不同（claude 逐檔即時、codex 每輪結束、kiro 每輪提示送出時、copilot 與 antigravity 只有工作階段結束時），談覆蓋範圍時一律據實分開講，不得寫成五支一樣。 - 所有非程式碼輸出一律繁體中文、UTF-8、無亂碼、無簡體字：程式碼註解、commit 訊息、PR 描述、wiki 頁、對使用者的回報、README 與各種文件都算。規則正文的唯一來源同樣是
plugins/meta的references/ste100.md，本存取庫只放hooks/lang-guard.sh的判定實作與hooks/simplified.txt的機檢字表。那份字表是本存取庫的單一真實來源，刻意排除繁體也在用的字（后、台、干、只、里、面、制、志），增刪前先確認不會製造誤報。lang-guard.sh的三種模式與掃描時機跟comment-scope.sh一致，但它掃整個檔案而不只掃註解行，.md與純文字檔也照掃。 hooks/write-guard.sh的三種模式只有 claude 接得上（其餘四支 CLI 沒有 PreToolUse），談覆蓋範圍時據實講，不得暗示每支 CLI 都擋得住。它只讀sdlc-gate.sh的階段鎖與skill-usage.sh的技能紀錄，不自己寫狀態檔；提交訊息的簡繁與編碼判定一律轉呼叫hooks/lang-guard.sh，本檔不留第二份樣式。- 主 agent 不需要處理細節的流程，一律建立 sub agent 處理。
呼叫慣例
Claude Code / Antigravity：/jsc-hooks:{name}；Codex：$name；Copilot / Kiro / OpenCode：描述需求自動觸發。