jiantw83
b23c546079
What：`skills/hooks-install/SKILL.md`、`README.md`、`AGENTS.md` 三份文件一併改寫註解範圍的覆蓋範圍說明：`comment-scope.sh` 由兩種模式改為三種，並以表格列出五個 CLI 各自的掃描時機——claude 逐檔即時（PostToolUse）、codex 每輪結束（`notify`）、kiro 每輪提示送出時（`userPromptSubmit`，掃的是上一輪寫的檔）、copilot 與 antigravity 只有工作階段結束時由 `tools/jsc-wrap.sh` 收尾掃一次。README 的 `tools/jsc-wrap.sh` 那列補上收尾 sweep 與「不影響結束碼」的約定，`smoke` 例外說明改成掃描模式通用。 Why：舊文件寫的是「四個 CLI 只剩規則提示」，接上 sweep 之後那句話已經不實。但也不能倒過來寫成五支一樣：時機差一輪或差一整個工作階段，操作者要知道自己現在用的 CLI 什麼時候才會收到警告。文件不同步，操作者會對保護程度有錯誤預期。 How：SKILL.md 全份維持英文，正文改用一張 CLI 對掃描時機的表格，並註明 sweep 讀的是 `git diff HEAD`、涵蓋範圍與 claude 相同、不在 git 工作區內就安靜 exit 0，frontmatter 的 `description` 不動；README.md 維持 STE100 繁中，hook 一覽表那列補上三種模式與各 CLI 時機，原本的降級段落換成同一張表；AGENTS.md 的第 5 條補上三種模式與「不得寫成五支一樣」的要求。 Who：`jsc-hooks` 的文件層與 `hooks-install` 技能，供操作者與後續 sub agent 依循。
1.7 KiB
1.7 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 只有工作階段結束時），談覆蓋範圍時一律據實分開講，不得寫成五支一樣。 - 主 agent 不需要處理細節的流程，一律建立 sub agent 處理。
呼叫慣例
Claude Code / Antigravity：/jsc-hooks:{name}；Codex：$name；Copilot / Kiro / OpenCode：描述需求自動觸發。