docs(spec-script-path): 更新單行 CLI 宣告範例,反映 persona 12 個 skill 已收斂為統一格式

寫法二的範例改為指向 spec-script-path 本身的單行引用格式,範例出處更新為 persona 全部 12 個已收斂的 skill。
This commit is contained in:
2026-08-12 05:52:45 +00:00
parent 9c2817660e
commit 44bd526dbd
+3 -4
View File
@@ -50,12 +50,11 @@ WORKLOG_DIR="<skill base directory>/../../scripts/worklog"
### 寫法二:單行 CLI 宣告版(適合整個 skill 只圍繞單一 CLI 腳本的情況)
```
**CLI**:`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`
(其他助理請改成本 plugin 目錄下的 `scripts/persona.mjs`;以下簡稱 `persona.mjs`)
**CLI**:路徑與呼叫慣例見 `/jsc-shared:spec-script-path`(本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`,一律帶 `--session <PERSONA_SESSION>`)。
```
之後全文的指令範例一律以 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" <子指令>` 的形式呈現;其他助理讀到這行時,依核心規則表格自行把 `${CLAUDE_PLUGIN_ROOT}` 換成 base directory 往上兩層推導出的路徑。
之後全文的指令範例一律以 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" <子指令>` 的形式呈現;其他助理讀到這行時,依核心規則表格自行把 `${CLAUDE_PLUGIN_ROOT}` 換成 base directory 往上兩層推導出的路徑。這一行只點出「本 skill 實際用哪支腳本、需不需要額外參數(如 `--session`)」,推導規則與絕不用相對路徑等鐵則一律回頭看本節,不在每個 skill 裡重複解釋。
(範例出處:`persona/skills/persona-chat/SKILL.md`、`persona/skills/persona-create/SKILL.md` 開頭的 `**CLI**:` 宣告行。)
(範例出處:`persona/skills/persona-chat/SKILL.md`、`persona/skills/persona-create/SKILL.md` 等 12 個 persona skill 開頭的 `**CLI**:` 宣告行,皆已收斂為此單行格式。)
兩種寫法本質是同一套「Claude Code 用環境變數、其他助理用 base directory 推導」規則的不同表達密度——寫法一把推導過程完整展開並存進一個變數方便全文引用,寫法二把推導過程收進一行宣告、後續直接照抄同一行指令模板。兩者都必須保留「絕不用相對路徑」與「解析不到就回報並停止」這兩條鐵則,不可省略。