jiantw83andClaude Sonnet 5
1030f9d403
依 todo.md 執行的規範治理專案：新增 spec-preflight 等 14 個共用規範（含 conventional-commit/pull-request/git-push/issue-read/todo-list/ask-user/ subagent/no-scratch-files/skill-invocation/script-path/action-scaffold/ node-src-layout/plugin-cli/model），擴充 spec-git-safety 與 spec-gitea（token 優先序、機密遮蔽、Wiki 頁名轉義規則）；新增可執行 skill `models`（模型能力 查詢與標籤）與 `todo`（依指定模型產生/附加 todo.md）；新增 plugin.meta.json 單一事實來源與 gen-plugin-files.mjs 樣板產生器，統一四個 repo 的 manifest／ README／AGENTS.md 並移除寫死的本機使用者路徑；新增 shared/scripts/lib 的 log／機密遮蔽三語言參考實作。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
21 lines
1.6 KiB
Markdown
21 lines
1.6 KiB
Markdown
---
|
||
name: spec-skill-invocation
|
||
description: JSC plugins 共用「skill 呼叫方式」：Claude Code／Antigravity 用 `/jsc-<plugin>:<name>` 斜線指令、Codex 用 `$name`、OpenCode 依 description 自動觸發，各助理呼叫一個 skill 的統一表格與說明。當其他 skill 內文引用 spec-skill-invocation 或 /jsc-shared:spec-skill-invocation、或需要在 skill 檔案末尾放「呼叫方式」章節時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
|
||
---
|
||
|
||
# spec-skill-invocation — 共用 skill 呼叫方式
|
||
|
||
所有 JSC skill 檔案末尾的「呼叫方式」章節，內容都是同一張表格（各助理如何呼叫一個 skill），不需要每個 skill 各自重複解釋——只要在該 skill 的「呼叫方式」章節引用本規範，或直接沿用下表即可。
|
||
|
||
## 呼叫方式表格
|
||
|
||
| 助理 | 呼叫 |
|
||
| --- | --- |
|
||
| Claude Code / Antigravity | `/jsc-<plugin>:<name>` 斜線指令 |
|
||
| Codex | `$name` |
|
||
| OpenCode | 依該 skill 的 description 自動觸發（不需使用者手動輸入指令） |
|
||
|
||
- `<plugin>` 為該 skill 所屬的 plugin 名稱（`code`／`doc`／`persona`／`shared`），`<name>` 為該 skill 的 `name`（frontmatter 內定義）。
|
||
- 各 skill 若帶參數，於自身「呼叫方式」章節列出實際參數格式與範例（可參考 `/jsc-code:image`、`/jsc-code:nuget`、`/jsc-doc:worklog` 等既有寫法），本規範只統一「各助理怎麼呼叫」這一段。
|
||
- OpenCode 沒有斜線指令或 `$name` 語法，使用者只需以自然語言描述需求，系統依 skill 的 `description` 自動比對觸發，不需額外指令。
|