# jsc-generic — 共用 Skills（跨 AI 助理）

本 repo 是一組以 **Agent Skills（`SKILL.md`）** 標準撰寫的共用 skills，可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。

## 給 AI 助理的指引

- 所有可用的 skills 位於本 repo 的 `skills/<name>/SKILL.md`。
- 在處理任務前，先比對使用者需求與各 skill `SKILL.md` frontmatter 的 `description`，若相符請載入並依其步驟執行。
- **呼叫慣例**：在 Claude Code 與 Antigravity 中，這些 skill 以 `/jsc-generic:<name>` 呼叫；Codex 以 `$<name>`、OpenCode 由模型依描述自動觸發 — 兩者沒有 `/jsc-generic:` 前綴，不需強制加。
- 完整清單與每個 skill 的用途，請見 `README.md` 的「Skills 目錄」。
- 部分 skill 帶可執行元件（`scripts/`）或 hook（`hooks/hooks.json`），**並非四家助理都適用**；載入前請看該 skill `description` 標示的支援範圍與 `README.md` 的「元件對各助理的適用範圍」。`hooks/hooks.json` 只有 Claude Code 會讀；以複製 `skills/` 目錄安裝的環境（OpenCode）不會帶入 `scripts/`，依賴腳本的 skill 一律不可用。

## 慣例

- 新增 skill 一律放在 `skills/<name>/`，且 `<name>` 使用小寫與連字號。
- `description` 要寫清楚觸發條件（何時用、何時不用），這是跨助理自動載入的唯一依據。