feat(shared): 新增14個共用spec、models/todo工具與樣板產生器,收斂跨repo重複規範
依 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>
This commit is contained in:
@@ -0,0 +1,20 @@
|
||||
---
|
||||
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` 自動比對觸發,不需額外指令。
|
||||
Reference in New Issue
Block a user