1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| hooks-install | Wire jsc hooks (STE100 guard, session timer, skill usage logger) into every installed AI CLI. Detect CLIs via jsc-cli detect-clis.sh, then apply native hook config per CLI or fall back to instruction files. Use after installing or updating the jsc plugin set; not for writing new hooks. |
hooks-install — 將 jsc hooks 接線到所有已安裝的 CLI
目標：讓三支 hook（ste100-guard.sh、session-timer.sh、skill-usage.sh）在每個 CLI 生效。
細節流程必須以 sub agent 執行，主 agent 只回報結果摘要。
步驟
- 執行
jsc-cli/tools/detect-clis.sh取得已安裝的 CLI 與路徑。 - 對每個 CLI 依下表接線（hook 優先，無 hook 系統就降級為規則檔）：
| CLI | 接線方式 |
|---|---|
| claude | plugin 安裝時自動載入 jsc-hooks/hooks/hooks.json，只需驗證：claude plugin list 有 jsc-hooks 且 /hooks 顯示已註冊 |
| codex | ~/.codex/config.toml 設定 notify 指向 session-timer.sh mark（帶 JSC_CLI=codex）；STE100 規則追加到 ~/.codex/AGENTS.md（prompt 降級） |
| copilot | 無 hook 系統：STE100 規則追加到 ~/.config/copilot/copilot-instructions.md（prompt 降級） |
| antigravity | 無公開 hook 系統：STE100 規則追加到全域 rules 檔（prompt 降級） |
| kiro | 於工作區 .kiro/hooks/ 建立 agent hook，觸發時執行對應腳本（帶 JSC_CLI=kiro） |
- 規則檔追加內容一律使用
ste100-guard.sh的輸出文字，且以<!-- jsc-hooks -->標記包住，重複執行時整段取代不重複追加。 - 回報每個 CLI 的接線結果（成功 / 降級為 prompt / 跳過原因）。
注意
- Hook 腳本同時接受 stdin JSON 與環境變數（
JSC_CLI、JSC_SESSION_ID、JSC_SKILL），wrapper 只需設環境變數。 - 資料落在
$JSC_HOME（預設~/.jsc），供jsc-log:worklog與jsc-log:stats取用。