shared/AGENTS.md

jsc — 共用 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:<name> 呼叫；Codex 以 $<name>、OpenCode 由模型依描述自動觸發 — 兩者沒有 /jsc: 前綴，不需強制加。
• 完整清單與每個 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 要寫清楚觸發條件（何時用、何時不用），這是跨助理自動載入的唯一依據。