From 44bd526dbdc61b8238a1cfa3ff77b1bcff6bc527 Mon Sep 17 00:00:00 2001
From: Jeffery <jiantw83@yahoo.com>
Date: Wed, 12 Aug 2026 05:52:45 +0000
Subject: [PATCH] =?UTF-8?q?docs(spec-script-path):=20=E6=9B=B4=E6=96=B0?=
 =?UTF-8?q?=E5=96=AE=E8=A1=8C=20CLI=20=E5=AE=A3=E5=91=8A=E7=AF=84=E4=BE=8B?=
 =?UTF-8?q?=EF=BC=8C=E5=8F=8D=E6=98=A0=20persona=2012=20=E5=80=8B=20skill?=
 =?UTF-8?q?=20=E5=B7=B2=E6=94=B6=E6=96=82=E7=82=BA=E7=B5=B1=E4=B8=80?=
 =?UTF-8?q?=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

寫法二的範例改為指向 spec-script-path 本身的單行引用格式，範例出處更新為 persona 全部 12 個已收斂的 skill。
---
 skills/spec-script-path/SKILL.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/skills/spec-script-path/SKILL.md b/skills/spec-script-path/SKILL.md
index 40315c6..1c547c3 100644
--- a/skills/spec-script-path/SKILL.md
+++ b/skills/spec-script-path/SKILL.md
@@ -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 推導」規則的不同表達密度——寫法一把推導過程完整展開並存進一個變數方便全文引用，寫法二把推導過程收進一行宣告、後續直接照抄同一行指令模板。兩者都必須保留「絕不用相對路徑」與「解析不到就回報並停止」這兩條鐵則，不可省略。