# jsc-hooks — 跨 CLI Hooks

jsc 技能組的 hooks domain：所有 hook **只放在這個 repo**（技能準則）。腳本為 POSIX shell，同時支援 stdin JSON（Claude 格式）與環境變數輸入，適用 claude / codex / copilot / antigravity / kiro。

## 安裝

```bash
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/hooks.git
claude plugin install jsc-hooks@hooks
```

其他 CLI（codex / copilot / antigravity / kiro）與批次安裝、更新、解除安裝：使用 `/jsc-cli:deploy`。

## Hooks

| 腳本 | 事件 | 作用 |
| --- | --- | --- |
| `hooks/ste100-guard.sh` | UserPromptSubmit | 注入 STE100 繁體中文輸出規則（hook > prompt 強制層） |
| `hooks/session-timer.sh` | SessionStart / Stop / SessionEnd | 記錄工作階段起訖；`report` 子指令供 `jsc-log:worklog` 取花費時間 |
| `hooks/skill-usage.sh` | PostToolUse(Skill) | 記錄技能使用與呼叫鏈到 `$JSC_HOME/usage/*.jsonl`，供 `jsc-log:stats` 統計 |

Claude 由 `hooks/hooks.json` 自動接線；其他 CLI 用 `hooks-install` 技能接線或降級為規則檔。

## Skills 目錄

呼叫方式：Claude / Antigravity `/jsc-hooks:{name}`；Codex `${name}`；Copilot / Kiro 描述需求自動觸發。

<!-- JSC-SKILLS:START -->

### `hooks-install`

把三支 hook 接線到所有已安裝的 CLI：偵測 CLI 後逐一套用原生 hook 設定，無 hook 系統的 CLI 降級為規則檔（以 `<!-- jsc-hooks -->` 標記整段取代，不重複追加）。

<!-- JSC-SKILLS:END -->

## 環境變數

| 變數 | 用途 | 未設定時 |
| --- | --- | --- |
| `JSC_HOME` | Hook 資料目錄 | 預設 `~/.jsc` |
| `JSC_CLI` / `JSC_SESSION_ID` / `JSC_SKILL` | 非 Claude CLI 接線時由 wrapper 設定 | 安靜降級 |

## 相關 domain

- `jsc-cli`：CLI 偵測（`tools/detect-clis.sh`）
- `jsc-log`：讀取本 domain 產出的工時與用量資料