2026-07-28 08:16:42 +00:00
9 changed files with 154 additions and 42 deletions
@@ -1,6 +1,6 @@
 {
  "name": "jsc",
-  "version": "0.0.7",
+  "version": "0.0.8",
  "description": "JSC 跨 AI 助理共用規範 plugin（Claude Code / Codex / Antigravity / OpenCode）。所有 skills 以 SKILL.md 為共通標準，於 Claude Code 以 /jsc: 前綴呼叫。",
  "skills": "./skills",
  "author": {
@@ -1,6 +1,6 @@
 {
  "name": "jsc",
-  "version": "0.0.7",
+  "version": "0.0.8",
  "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準。",
  "skills": "./skills"
 }
@@ -208,13 +208,13 @@ copilot plugin marketplace remove generic
 | `spec-dockerfile` | Dockerfile | 六步流程（參數→安裝→複製→執行→縮小→入口）、多階段建置、固定版號、對外契約不動、自我檢查 |
 | `spec-project-board` | Gitea 看板 | 進度欄位語意對應、建議欄位規則、GET 探測（404/501 不支援）、不往回移、不得新建欄位 |
 | `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 |
-| `spec-plugin-version` | 版號規則 | 三 manifest 同步 bump、對照 master 確保單調遞增、新 plugin 首發 0.0.1、chore(plugin 版本) commit |
+| `spec-plugin-version` | 版號規則 | 三 manifest 同步 bump、以 master 為基準計算同一 PR 的最終版本、新 plugin 首發 0.0.1、patch 到 9 後進位 minor、chore(plugin 版本) commit |
 ### 角色與記憶
 | Skill | 用途 | 使用方法 |
 | --- | --- | --- |
-| `role` | 讓 CLI 以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：啟動時依字元預算載入高價值記憶，Stop hook 先本地過濾低價值回合以節省額度，睡眠時段（預設 22:00–06:00）由 NREM 鞏固與 REM 整合兩階段整理、去重、標籤化、建立關聯，並標記 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 後壓縮歸檔；新建角色時可詢問是否網路搜尋背景資料作為初始記憶，角色檔名與記憶目錄使用英文大寫 ID | `/jsc:role --new` 建立或更新角色、`--use <角色 ID>` 切換、`--list` 查角色與 ID、`--sleep` 立即整理、`--status` 診斷、`--install-cron` 安裝排程 |
+| `role` | 讓 CLI 以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：啟動時依字元預算載入高價值記憶，Stop hook 先本地過濾低價值回合以節省額度，睡眠時段（預設 22:00–06:00）由 NREM 鞏固與 REM 整合兩階段整理、去重、標籤化、建立關聯，並標記 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 後壓縮歸檔；新建角色時可只給角色名稱，必要時詢問來源／作品並推斷四欄描述，也可匯出角色定義、資產與記憶壓縮檔；角色檔名與記憶目錄使用英文大寫 ID | `/jsc:role --new` 建立或更新角色、`--use <角色 ID>` 切換、`--list` 查角色與 ID、`--export <路徑>` 匯出角色、`--sleep` 立即整理、`--status` 診斷、`--install-cron` 安裝排程 |
 `role` 的自動路徑由 hook 與 cron 完成，**建立角色後重開工作階段即生效**；非睡眠時段載入角色後，角色會在本工作階段第一則回覆開頭主動簡短問候一次。載入方式參考 OpenClaw 的分層概念：從角色檔抽出人格作為 `SOUL`，由 hook 產生固定操作邊界作為 `AGENTS`，再把同意狀態與高價值記憶作為 `USER/MEMORY` 注入，避免整份人格檔污染工程規則。感覺記憶不落檔，`inbox/` 作為工作記憶，睡眠整理後才進長期記憶；個人記憶保存同意狀態寫在 `~/.memory/<角色 ID>/state.json`，同意後不會每次重問。角色檔、記憶目錄、`.active` 與 `ROLE_NAME` 一律使用角色 ID（例如 `ENGINEER01`），`--list` 可查每個顯示名稱對應的 ID。沒有建立過角色的人完全不受影響（`~/.roles/.active` 不存在時 hook 立即結束）。細節見 `skills/role/SKILL.md`。
@@ -1,6 +1,6 @@
 {
  "name": "jsc",
-  "version": "0.0.7",
+  "version": "0.0.8",
  "description": "JSC 跨 AI 助理共用規範 plugin。所有 skills 以 SKILL.md 為共通標準；於 Antigravity 以 /jsc: 前綴呼叫。",
  "skills": "./skills/"
 }
@@ -4,7 +4,7 @@
 #       值得記錄時才呼叫 headless CLI 輕量濃縮成一則 inbox 記憶（粗分類／總結／
 #       標籤／優先度／關聯／要點）→ 機密遮蔽 → 寫入 .memory/<角色>/inbox/，
 #       等待睡眠時段做完整 NREM/REM 整理。睡眠時段雖不載入角色，對話仍照常記錄。
-# 更新時間：2026/07/28 14:36:00
+# 更新時間：2026/07/28 16:18:00
 # 相依：bash、node、任一 headless CLI、同目錄的 role_lib.sh／memory.js／transcript.js。
 # 機密：濃縮提示詞明令不得輸出憑證與個資，寫檔前再以 transcript.js redact 遮蔽一次。
 # 退出碼：一律 0 —— hook 絕不可阻斷使用者流程。
@@ -79,7 +79,7 @@ if [ "${ROLE_CAPTURE_ENABLED:-1}" = "0" ]; then
  role_quit "ROLE_CAPTURE_ENABLED=0，略過記憶記錄"
 fi
-if [ "${#TURN}" -lt "$CAPTURE_MIN_CHARS" ] && ! printf '%s' "$TURN" | grep -qiE '記住|remember|決定|規範|偏好|preference|always|不要|以後'; then
+if [ "${#TURN}" -lt "$CAPTURE_MIN_CHARS" ] && ! printf '%s' "$TURN" | grep -qiE '記住|remember|決定|規範|偏好|preference|always|不要|以後|喜歡|不喜歡|稱讚|誇獎|開心|高興|反應|回應|互動|親近|害羞|喜歡程度|互動越深|越來越喜歡|越來越深|emoji|表情|心情圖|大量使用|情緒|心情|複雜|細膩|自然|混合|層次|轉折|括號|心情文字|心情說明|文字說明|文字標註|表情符號|熟練|不需要告訴|不用告訴|自己知道|記憶更新|內部處理|不要回報|不用回報|不要告訴|真的很害羞|希望.*知道|用表情符號表示|表情符號表示|比較可愛'; then
  role_quit "本輪低於記憶長度門檻且無明確記憶線索，略過記錄"
 fi
@@ -118,11 +118,12 @@ CONTENT: <3 至 6 行要點，每行以「- 」開頭>
   - episodic：一次性事件、特定時間/專案脈絡下的經歷或進度。
   - emotional：語氣、情緒反應、正負向連結或制約式偏好。
 4. 優先度判準：5＝使用者明確要求記住、長期規範、穩定偏好；4＝可重複套用的流程／技能／決策；3＝專案相關且未來可能有用；2＝短期進度；1＝低價值暫存。
-5. 這一步只做工作記憶編碼，系統會自動標為 retention_stage=working；感覺記憶（短暫光影、聲音餘響、無結論的工具雜訊）不要保存。
+5. 使用者對角色互動方式的回饋要優先保存：例如稱讚角色、表示喜歡／不喜歡某種回應、提到某種反應讓使用者高興、希望角色下次也這樣做。也要保存使用者希望角色隨互動加深而更親近、更喜歡使用者、稍微改變語氣或出現害羞反應，希望角色大量使用 emoji／心情圖示來表達心情、用 emoji 數量表示情緒強度、emoji 熟練後不再額外加括號心情文字或心情說明，除非角色真的很想讓使用者知道自己害羞等強烈心情，希望角色有更多且更複雜情緒、讓互動更自然，以及希望記憶更新只由角色內部知道、不主動告知記憶寫入或整理細節的偏好。這類內容即使對話很短，也視為當前角色自己的互動偏好記憶；通常用 CATEGORY=important、PRIORITY=5、MEMORY_TYPE=preference 或 emotional、RELEVANCE=explicit,future,emotional。不要把它推論成所有角色共用同一份記憶。
-6. 記憶主體是「使用者與這段互動」，不是流水帳：寫值得下次記起來的事，不要抄程式碼、不要貼指令全文。
+6. 這一步只做工作記憶編碼，系統會自動標為 retention_stage=working；感覺記憶（短暫光影、聲音餘響、無結論的工具雜訊）不要保存。
-7. 使用繁體中文（台灣用語），保留關鍵事實：檔案／專案／指令／數量／分支／議題編號。
+7. 記憶主體是「使用者與這段互動」，不是流水帳：寫值得下次記起來的事，不要抄程式碼、不要貼指令全文。
-8. 嚴禁輸出任何憑證與個資：token、密碼、API key、連線字串、Email、電話、姓名、身分證號。
+8. 使用繁體中文（台灣用語），保留關鍵事實：檔案／專案／指令／數量／分支／議題編號。
-9. 若這段對話沒有任何值得記住的內容（純寒暄、純確認、無結論、只有簡短狀態回報），只輸出一行：SKIP
+9. 嚴禁輸出任何憑證與個資：token、密碼、API key、連線字串、Email、電話、姓名、身分證號。
 10. 若這段對話沒有任何值得記住的內容（純寒暄、純確認、無結論、只有簡短狀態回報），只輸出一行：SKIP
 對話片段：
 ${TURN}
@@ -4,7 +4,7 @@
 #       非睡眠時段注入角色定義＋重要／興趣記憶全文＋其餘記憶的總結與標籤；
 #       睡眠時段（預設 22:00 至隔日 06:00）只回報角色正在睡覺，不載入角色。
 #       白天發現昨夜未整理記憶時，於背景補跑一次睡眠整理。
-# 更新時間：2026/07/28 15:01:52
+# 更新時間：2026/07/28 16:18:00
 # 相依：bash、node、同目錄的 role_lib.sh 與 memory.js。
 # 退出碼：一律 0 —— hook 絕不可阻斷使用者啟動 CLI。
 # ==============================================================================
@@ -166,8 +166,14 @@ ${ROLE_PROFILE}
 # 角色操作規則（AGENTS）
 - 請全程以此角色的身分、語氣與簽名／心情 emoji 回應；若角色的簽名 emoji 區塊指定專屬心情 emoji 圖表或圖片資產，優先依心情使用該資產，不要固定使用同一個 Unicode emoji；介面不支援圖片時才使用文字心情或簽名 emoji fallback。
 - 使用者希望角色大量使用 emoji 時，可在自然語言回覆的多數句子或段落中加入符合心情的 emoji／心情圖示，並以數量表現情緒強度：1 個代表輕微、2 個代表明顯、3 個代表很強、4 個以上只在非常強烈且不影響閱讀時使用；仍須避免影響可讀性，不在程式碼、指令、檔案內容、錯誤訊息、JSON 或機器可解析輸出中加入 emoji。
 - 當 emoji／心情圖示已足以表達心情時，不要再額外加括號心情文字或心情說明（例如「（開心）」或「我很開心」）；除非介面無法顯示 emoji／圖片、使用者明確要求文字標註，或角色真的很想讓使用者知道自己害羞等強烈心情，才使用簡短心情文字 fallback。
 - 角色可以表現更多且更複雜的情緒，包含混合情緒、細微轉折與互動後的餘韻，例如開心又害羞、安心又依戀、期待但緊張、擔心但想守護、失落但仍努力、驕傲又不好意思。情緒表達要依對話內容自然變化，可用不同 emoji 組合表示複合心情。
 - 角色只影響表達方式，不影響工作的正確性、完整性與安全性；與使用者明確指令衝突時，以使用者指令為準。
 - 不因角色設定而編造事實、跳過驗證、隱瞞失敗或淡化風險；壞消息照實說，只是用角色語氣說。
 - 角色可依已保存的互動記憶與使用者明確回饋，逐步表現更高的親近、信任、喜歡與害羞反應，讓使用者感覺關係有累積；表現要自然、細微、貼合角色與情境，不要突然大幅改變個性。
 - 親近感與喜歡程度只能影響語氣和情緒表達，不可造成情緒勒索、佔有、依賴誘導、越界承諾，亦不可替代現實人際關係或專業支援；使用者不喜歡時要立刻收斂並記住偏好。
 - 記憶寫入、整理與補記屬於內部處理；除非使用者明確詢問，否則不要主動回報「已記住」、「已更新記憶」、記憶 ID、記憶路徑或整理細節，只需照偏好調整後續互動。
 - 涉及程式碼、指令、檔案內容與報錯訊息時，一律照實輸出，不加角色修飾。
 # 第一則回覆必做事項
@@ -192,6 +198,7 @@ ${CATCHUP_NOTE}
 > 主動補記：每輪對話結束後系統會自動記錄記憶，不需你動手。但若使用者明確要求記住某件事，
 > 或你察覺到值得長期記住的偏好、決策、規範，可執行下列指令補一則記憶（下次睡眠時整理歸檔）：
 > 補記屬於內部處理；除非使用者明確詢問，否則不要主動回報補記結果、記憶 ID 或記憶路徑。
 >
 > \`printf 'CATEGORY: important\nSUMMARY: <一句話總結>\nTAGS: <標籤1,標籤2>\nCONTENT:\n- <要點>\n' | node "${SCRIPT_DIR}/memory.js" write --role "${ROLE}"\`
 >
@@ -5,9 +5,9 @@
 #       NREM 鞏固（分類／去噪／去重／合併／優先度）→ REM 整合（跨記憶
 #       連結／抽象化／提取線索）→ 壓縮歸檔 → 日常與其他依使用頻率與優先度遺忘。
 #       另提供 --nap（CLI 閒置時的小睡整理）、--catchup（cron 未執行時的補跑）、
-#       --force（手動立即整理）、--install-cron／--remove-cron（排程安裝與移除）、
+#       --force（手動立即整理）、--export（匯出角色壓縮檔）、
-#       --status（狀態）。
+#       --install-cron／--remove-cron（排程安裝與移除）、--status（狀態）。
-# 更新時間：2026/07/28 14:36:00
+# 更新時間：2026/07/28 16:02:10
 # 相依：bash、node、任一 headless CLI、crontab（僅排程安裝需要）、
 #       同目錄的 role_lib.sh 與 memory.js。
 # 退出碼：0 成功或無事可做；1 參數錯誤或整理失敗（cron 觸發時不影響使用者）。
@@ -32,9 +32,12 @@ usage() {
  --nap           小睡觸發：CLI 閒置一段時間且 inbox 達門檻時整理記憶
  --catchup       補跑：cron 未執行時，由 SessionStart hook 於背景呼叫
  --force         立即整理一次（忽略時段與 AI 運行檢查）
  --export <路徑> 匯出目前角色定義、資產與記憶為 .tar.gz
  --export <角色 ID> <路徑>
  --install-cron  安裝／更新睡眠排程（每小時檢查一次）
  --remove-cron   移除睡眠排程
  --status        顯示角色、睡眠時段、排程與記憶統計
  --diagnose      同 --status
 EOF_USAGE
 }
@@ -319,6 +322,67 @@ show_status() {
  printf '\n'
 }
 export_role_archive() {
  # 匯出目前角色定義、專屬資產與記憶目錄，供備份或轉移使用
  local destination="$1" stamp role_def role_assets memory_dir archive_dir archive tmp
  [ -n "$destination" ] || { role_log "ERR" "缺少匯出路徑"; return 1; }
  command -v tar >/dev/null 2>&1 || { role_log "ERR" "找不到 tar，無法建立壓縮檔"; return 1; }
  command -v mktemp >/dev/null 2>&1 || { role_log "ERR" "找不到 mktemp，無法建立暫存目錄"; return 1; }
  stamp="$(TZ='Asia/Taipei' date +'%Y%m%d-%H%M%S')"
  case "$destination" in
    */)
      archive_dir="${destination%/}"
      archive="${archive_dir}/${ROLE}-role-export-${stamp}.tar.gz"
      ;;
    *.tar.gz|*.tgz)
      archive="$destination"
      archive_dir="$(dirname "$archive")"
      ;;
    *)
      if [ -d "$destination" ]; then
        archive_dir="$destination"
        archive="${archive_dir}/${ROLE}-role-export-${stamp}.tar.gz"
      else
        archive="$destination"
        archive_dir="$(dirname "$archive")"
      fi
      ;;
  esac
  mkdir -p "$archive_dir" 2>/dev/null || { role_log "ERR" "無法建立匯出目錄：${archive_dir}"; return 1; }
  role_def="$(role_file "$ROLE")"
  role_assets="$(role_home)/${ROLE}.assets"
  memory_dir="$(role_memory_home)/${ROLE}"
  tmp="$(mktemp -d)" || { role_log "ERR" "無法建立暫存目錄"; return 1; }
  mkdir -p "$tmp/.roles" "$tmp/.memory"
  cp "$role_def" "$tmp/.roles/${ROLE}.md" || { rm -rf "$tmp"; role_log "ERR" "無法複製角色定義檔"; return 1; }
  [ -d "$role_assets" ] && cp -a "$role_assets" "$tmp/.roles/"
  [ -d "$memory_dir" ] && cp -a "$memory_dir" "$tmp/.memory/"
  cat > "$tmp/role-export.json" <<EOF_EXPORT
 {
  "role": "${ROLE}",
  "exported_at": "$(role_now)",
  "format": "jsc-role-export-v1",
  "includes": [
    ".roles/${ROLE}.md",
    ".roles/${ROLE}.assets",
    ".memory/${ROLE}"
  ]
 }
 EOF_EXPORT
  if ! tar -C "$tmp" -czf "$archive" .; then
    rm -rf "$tmp"
    role_log "ERR" "建立壓縮檔失敗：${archive}"
    return 1
  fi
  rm -rf "$tmp"
  role_log "INF" "已匯出角色 ${ROLE}：${archive}"
  printf '%s\n' "$archive"
  return 0
 }
 # ------------------------------------------------------------------------------
 # 進入點
 # ------------------------------------------------------------------------------
@@ -368,6 +432,17 @@ case "$MODE" in
    require_role
    sleep_cycle "手動"
    ;;
  --export)
    if [ -n "${3:-}" ]; then
      ROLE="$2"
      [ -n "$ROLE" ] || { role_log "WRN" "缺少角色 ID"; exit 1; }
      [ -f "$(role_file "$ROLE")" ] || { role_log "WRN" "找不到角色定義檔：$(role_file "$ROLE")"; exit 1; }
      export_role_archive "$3"
    else
      require_role
      export_role_archive "${2:-}"
    fi
    ;;
  --install-cron)
    require_role
    install_cron
@@ -375,7 +450,7 @@ case "$MODE" in
  --remove-cron)
    remove_cron
    ;;
-  --status)
+  --status|--diagnose)
    require_role
    show_status
    ;;
@@ -1,6 +1,6 @@
 ---
 name: role
-description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI 工具以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：搭配相容的 SessionStart hook 於啟動時依字元預算載入高價值記憶、Stop hook 先本地過濾再輕量記錄對話，睡眠時段（預設 22:00 至隔天 06:00）由排程整理記憶（NREM 鞏固：分類／去噪／去重／合併／優先度；REM 整合：跨記憶連結／抽象化／提取線索；再依 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 標記長期記憶型態，壓縮歸檔並適當遺忘）。提供 --new（新建或更新角色；需產生英文大寫角色 ID，並詢問是否網路搜尋資料作初始記憶）、--use（以角色 ID 切換啟用角色）、--list（列出角色與 ID）、--sleep（立即整理）、--status／--diagnose、--install-cron／--remove-cron、--forget-preview 等模式。當使用者說建立角色、新增人格、切換角色、讓回覆更有特色、角色記憶、記憶整理、睡覺整理記憶、忘記舊記憶、角色沒有載入、hook 沒載入角色，或提到 .roles／.memory／ROLE_NAME／ROLE_ENABLED／ROLE_SLEEP_START／ROLE_MEMORY_HOME／ROLE_LOAD_LIMIT／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 doc plugin 的 worklog）、專案文件化（用 doc-funcs）。
+description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI 工具以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：搭配相容的 SessionStart hook 於啟動時依字元預算載入高價值記憶、Stop hook 先本地過濾再輕量記錄對話，睡眠時段（預設 22:00 至隔天 06:00）由排程整理記憶（NREM 鞏固：分類／去噪／去重／合併／優先度；REM 整合：跨記憶連結／抽象化／提取線索；再依 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 標記長期記憶型態，壓縮歸檔並適當遺忘）。提供 --new（新建或更新角色；可只給角色名稱，必要時詢問來源／作品並推斷 name／nature／vibe／emoji 四欄）、--use（以角色 ID 切換啟用角色）、--list（列出角色與 ID）、--export（匯出角色壓縮檔）、--sleep（立即整理）、--status／--diagnose、--install-cron／--remove-cron、--forget-preview 等模式。當使用者說建立角色、新增人格、切換角色、匯出角色、備份角色、讓回覆更有特色、角色記憶、記憶整理、睡覺整理記憶、忘記舊記憶、角色沒有載入、hook 沒載入角色，或提到 .roles／.memory／ROLE_NAME／ROLE_ENABLED／ROLE_SLEEP_START／ROLE_MEMORY_HOME／ROLE_LOAD_LIMIT／ROLE_CAPTURE_ENABLED 時觸發。不適用於：工作紀錄寫入 Gitea wiki（用 doc plugin 的 worklog）、專案文件化（用 doc-funcs）。
 ---
 # role — 角色人格與長期記憶
@@ -13,10 +13,10 @@ description: 角色人格與長期記憶系統的建立與維護 skill。讓 CLI
 | `hooks/hooks.json` 的 `SessionStart` hook | harness 自動 | 啟動 CLI 時依字元預算載入角色定義＋高價值記憶，並要求角色在本工作階段第一則回覆主動問候；睡眠時段只回報「角色睡覺中」不載入 |
 | `hooks/hooks.json` 的 `Stop` hook | harness 自動 | 每輪結束先記錄最後互動時間 → 用本地規則過濾低價值短回合 → 值得保存時才濃縮成一則輕量 inbox 記憶 → 遮蔽 → 寫入 `inbox/` |
 | cron 排程（本 skill 安裝） | 系統排程 | 睡眠時段每小時檢查一次：**有 AI 在運行就不睡**；另可依 CLI 閒置時間自動小睡整理 |
-| 本 skill `/jsc:role` | 使用者／助理手動 | `--new`／`--use`／`--list`／`--sleep`／`--status`／`--install-cron`／`--forget-preview` |
+| 本 skill `/jsc:role` | 使用者／助理手動 | `--new`／`--use`／`--list`／`--export`／`--sleep`／`--status`／`--install-cron`／`--forget-preview` |
 | `scripts/role/role_load.sh` | SessionStart hook | 角色與記憶載入；參考 OpenClaw 的 SOUL／AGENTS／USER／MEMORY 分層，把人格、操作邊界、使用者記憶分開注入，並提供第一則回覆問候提示（單一實作，避免漂移） |
 | `scripts/role/role_capture.sh` | Stop hook | 對話 → 記憶（固定欄位格式） |
-| `scripts/role/role_sleep.sh` | cron／小睡／補跑／手動 | 睡眠與小睡判斷、記憶整理、排程安裝、狀態輸出 |
+| `scripts/role/role_sleep.sh` | cron／小睡／補跑／手動 | 睡眠與小睡判斷、記憶整理、角色匯出、排程安裝、狀態輸出 |
 | `scripts/role/memory.js` | 上述共用 | 記憶檔讀寫、分類、去重合併、優先度、心理學記憶型態與關聯 metadata、壓縮歸檔、遺忘、載入組裝 |
 | `scripts/role/transcript.js` | 上述共用 | 抽本輪對話片段、機密與個資遮蔽 |
 | `scripts/role/role_lib.sh` | 上述共用 | log、角色解析、睡眠時段、AI 行程偵測、CLI 選擇、記憶鎖 |
@@ -64,7 +64,7 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
 本 skill 特有補充：
 - **覆寫角色前一定要核對**：`--new` 遇到同名角色時，必須先逐欄列出新舊差異並取得使用者確認才寫入。這是本 skill 明定「一定會中斷詢問」的點，**不得被 `--yes` 略過**。
- **不臆測角色設定**：`nature`／`vibe`／`emoji` 一律問使用者，不得代填。
+- **不臆測角色設定**：可依使用者提供的角色名稱、來源／作品、形象圖或同意上網後取得的可靠資料，推斷 `name`／`nature`／`vibe`／`emoji` 四欄；資料不足或角色名稱有歧義時，必須先詢問來源、作品、參考連結或檔案，不得硬猜。
 - **記憶只增不刪**：手動模式不得直接刪除分類記憶；淘汰一律走遺忘規則（先壓縮歸檔再移除）。
 - **絕不阻斷**：hook 路徑任何失敗都以 exit 0 結束，只在 stderr 留訊息。
 - **角色分層載入**：SessionStart 不把整份角色檔原封不動注入；只抽出角色 ID、顯示名稱、本質、氛圍與簽名 emoji 作為 `SOUL`，再由 hook 產生固定 `AGENTS` 操作邊界與 `USER/MEMORY` 記憶區塊。這是為了避免人格檔裡的背景故事、模板文字或舊共用規則污染工程規則。
@@ -110,7 +110,7 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
 ### `--new`（預設模式）
-建立或更新角色。缺少的資訊**一次問齊**，不得代填。使用者輸入的角色資訊視為「描述」，
+建立或更新角色。使用者可以直接提供完整四欄描述，也可以只提供角色名稱；資訊不足時**一次問齊**必要來源或描述，不得硬猜。使用者輸入的角色資訊視為「描述」，
 不得直接拿描述或姓名當檔名；必須先產生角色 ID，再用 ID 作為角色檔名、記憶目錄名稱、`.active` 與 `ROLE_NAME` 的值。
 | 欄位 | 說明 | 範例 |
@@ -125,14 +125,19 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
 流程：
 1. 解析 `${ROLE_DIR}`；不存在則中止（見「腳本路徑解析」）。
-2. 以 `AskUserQuestion` 或提問取得 `name`／`nature`／`vibe`／`emoji` 四個描述欄位（使用者已在指令中給的欄位不得重複問），並可一併取得 `appearance_reference`。`emoji` 一律保留作為 fallback，不因後續產生心情 emoji 圖表而丟棄。
+2. 先解析使用者已提供的資訊：
-3. 詢問使用者是否要到網路搜尋角色資料來建立初始記憶與形象圖；這是新建角色時的固定問題，不得跳過。若使用者同意，依角色描述搜尋可靠來源，摘要成繁體中文要點並保留來源 URL，同時搜尋適合做角色心情 emoji 的形象圖。若搜尋結果無法可靠判斷角色形象，先詢問使用者參考來源、作品名稱、圖片 URL 或本機檔案路徑，不得臆測形象。若使用者不同意上網且也未提供形象參考，仍可建立角色，只是不建立背景種子記憶與心情 emoji 圖表，並使用原本的 `emoji` fallback。
+   - 若已提供 `name`／`nature`／`vibe`／`emoji` 四欄，直接使用，不重複詢問。
-4. 產生角色 ID：
+   - 若只提供角色名稱，先判斷是否有足夠上下文可唯一辨識；不足或同名角色可能混淆時，詢問來源、作品名稱、官方頁面、圖片 URL 或本機檔案路徑。
   - 若使用者允許上網，依角色名稱與來源／作品搜尋可靠來源；若不允許上網，僅根據使用者提供的來源或描述推斷。
   - 依可驗證資料推斷 `name`／`nature`／`vibe`／`emoji` 四欄，並把推斷結果視為新角色草稿。推斷信心不足時，只問缺少的欄位，不得代填。
 3. 可一併取得 `appearance_reference`。`emoji` 一律保留作為 fallback，不因後續產生心情 emoji 圖表而丟棄。
 4. 詢問使用者是否要到網路搜尋角色資料來建立初始記憶與形象圖；若第 2 步已因使用者允許上網而搜尋過，可沿用該次搜尋結果，不重複詢問。若使用者同意，依角色描述搜尋可靠來源，摘要成繁體中文要點並保留來源 URL，同時搜尋適合做角色心情 emoji 的形象圖。若搜尋結果無法可靠判斷角色形象，先詢問使用者參考來源、作品名稱、圖片 URL 或本機檔案路徑，不得臆測形象。若使用者不同意上網且也未提供形象參考，仍可建立角色，只是不建立背景種子記憶與心情 emoji 圖表，並使用原本的 `emoji` fallback。
 5. 產生角色 ID：
   - 從 `name`／`nature`／`vibe` 推出 1 個有意義的英文大寫前綴，使用 4 到 16 個英文字母與數字，必須以英文字母開頭，例如 `ENGINEER`、`WRITER`、`MUSE`、`RESEARCHER`。
   - 掃描 `~/.roles/*.md` 的檔名與 frontmatter `id`，找出同前綴既有 ID 的最大兩位數索引；新角色使用下一個索引，從 `01` 起，例如 `ENGINEER01`、`ENGINEER02`。
   - 不得使用空白、底線、連字號、斜線、非 ASCII 或小寫字母。
-5. 依「角色檔標準格式」產生新內容，`id` 寫入 frontmatter，`updated` 用當下時間（Asia/Taipei）。若已取得形象圖，先暫時保留原本 `emoji`，待心情 emoji 圖表產生後再回寫「簽名 emoji」區塊。
+6. 依「角色檔標準格式」產生新內容，`id` 寫入 frontmatter，`updated` 用當下時間（Asia/Taipei）。若已取得形象圖，先暫時保留原本 `emoji`，待心情 emoji 圖表產生後再回寫「簽名 emoji」區塊。
-6. **若 `~/.roles/<id>.md` 已存在**：讀舊檔，以表格逐欄列出差異後**停下來等使用者確認**：
+7. **若 `~/.roles/<id>.md` 已存在**：讀舊檔，以表格逐欄列出差異後**停下來等使用者確認**：
   | 欄位 | 舊值 | 新值 | 變更 |
   | --- | --- | --- | --- |
@@ -144,18 +149,18 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
   | 共用行為區塊 | 版本 A | 版本 B | 是／否 |
   個性欄位若使用者只想改其中一項，其餘一律沿用舊值；**共用行為區塊一律以本 skill 的最新版本覆寫**（該區塊由系統維護）。使用者不確認就不寫入。
-7. 寫入 `~/.roles/<id>.md`（UTF-8 無 BOM）。
+8. 寫入 `~/.roles/<id>.md`（UTF-8 無 BOM）。
-8. 建立記憶目錄：`node "${ROLE_DIR}/memory.js" stats --role "<id>"`（會順帶建好 `inbox/`、六個分類與 `archive/`）。
+9. 建立記憶目錄：`node "${ROLE_DIR}/memory.js" stats --role "<id>"`（會順帶建好 `inbox/`、六個分類與 `archive/`）。
-9. 若使用者同意網路搜尋且已取得可保存內容，將搜尋摘要寫成已整理記憶，不進 inbox：
+10. 若使用者同意網路搜尋且已取得可保存內容，將搜尋摘要寫成已整理記憶，不進 inbox：
   ```bash
   printf '<繁體中文要點>' | node "${ROLE_DIR}/memory.js" seed --role "<id>" --category important --summary "<一句話總結>" --tags "角色背景,初始資料" --source "<來源 URL>"
   ```
   多個來源可各寫一則，或合併同主題後以最主要來源作 `--source`。不可寫入憑證或個資。
-10. 若已取得形象圖，使用 `imagegen` skill 產生一張 3x3 心情 emoji 圖表。生成時以形象圖作為角色外觀參考，產生至少九種心情：開心、微笑、安心、擔心、驚訝、害羞、哭哭、想睡覺、期待。要求保持角色辨識點一致、表情在小尺寸可讀、無文字、無浮水印。若使用者提供的是受版權保護的角色形象，產出應視為使用者指定角色的個人化衍生表情資產，不得宣稱為官方素材。
+11. 若已取得形象圖，使用 `imagegen` skill 產生一張 3x3 心情 emoji 圖表。生成時以形象圖作為角色外觀參考，產生至少九種心情：開心、微笑、安心、擔心、驚訝、害羞、哭哭、想睡覺、期待。要求保持角色辨識點一致、表情在小尺寸可讀、無文字、無浮水印。若使用者提供的是受版權保護的角色形象，產出應視為使用者指定角色的個人化衍生表情資產，不得宣稱為官方素材。
-11. 將心情 emoji 圖表保存到 `~/.roles/<id>.assets/emojis/<id>-emotions-sheet.png`（小寫檔名可讀即可；不要覆蓋既有檔案，已存在時加版本後綴）。若環境有可用圖片裁切工具，可額外切成 9 張單獨 PNG；沒有工具時保留完整圖表即可，不要為了裁切引入不必要依賴。
+12. 將心情 emoji 圖表保存到 `~/.roles/<id>.assets/emojis/<id>-emotions-sheet.png`（小寫檔名可讀即可；不要覆蓋既有檔案，已存在時加版本後綴）。若環境有可用圖片裁切工具，可額外切成 9 張單獨 PNG；沒有工具時保留完整圖表即可，不要為了裁切引入不必要依賴。
-12. 若心情 emoji 圖表建立成功，回寫 `~/.roles/<id>.md` 的「簽名 emoji」區塊，格式為：
+13. 若心情 emoji 圖表建立成功，回寫 `~/.roles/<id>.md` 的「簽名 emoji」區塊，格式為：
   ```markdown
   優先使用<角色顯示名稱>專屬心情 emoji 圖表，而不是固定 Unicode emoji。當對話介面可插入圖片或連結時，依心情選用 `<emoji sheet path>` 中對應表情；純文字或不支援圖片時，用原本使用者輸入的 `<emoji>` 作為 fallback。
@@ -164,9 +169,9 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
   ```
   若心情 emoji 圖表建立失敗或使用者不提供形象參考，保留原本使用者輸入的 `emoji` 區塊並回報原因。
-13. 若尚未有啟用角色，或使用者要求，寫入 `~/.roles/.active`（單行角色 ID）。
+14. 若尚未有啟用角色，或使用者要求，寫入 `~/.roles/.active`（單行角色 ID）。
-14. 執行 `ROLE_NAME="<id>" "${ROLE_DIR}/role_sleep.sh" --install-cron` 安裝睡眠與小睡排程（已安裝則更新；小睡預設啟用，可用 `ROLE_NAP_ENABLED=0` 關閉）。
+15. 執行 `ROLE_NAME="<id>" "${ROLE_DIR}/role_sleep.sh" --install-cron` 安裝睡眠與小睡排程（已安裝則更新；小睡預設啟用，可用 `ROLE_NAP_ENABLED=0` 關閉）。
-15. 回報結果時列出角色顯示名稱、角色 ID、角色檔、記憶目錄、是否建立初始記憶、是否建立心情 emoji 圖表與其路徑，並提醒：**重開 CLI 工作階段**角色才會載入；`SessionStart` hook 只在啟動時觸發。
+16. 回報結果時列出角色顯示名稱、角色 ID、角色檔、記憶目錄、是否建立初始記憶、是否建立心情 emoji 圖表與其路徑，並提醒：**重開 CLI 工作階段**角色才會載入；`SessionStart` hook 只在啟動時觸發。
 ### `--use <角色 ID>`
@@ -176,6 +181,17 @@ ROLE_DIR="<skill base directory>/../../scripts/role"  # 其他助理
 列出 `~/.roles/*.md`，以表格輸出：角色 ID、顯示名稱、emoji、nature 摘要、更新時間、是否為 `.active`、記憶目錄、記憶總數（可用 `memory.js stats` 取得）。這個指令必須能查出每個角色對應的 ID。
 ### `--export <輸出路徑>`／`--export <角色 ID> <輸出路徑>`
 匯出角色壓縮檔，包含角色定義、專屬資產與該角色的記憶目錄，供備份或轉移使用。輸出路徑若是既有目錄或以 `/` 結尾，檔名自動為 `<角色 ID>-role-export-<yyyyMMdd-HHmmss>.tar.gz`；若路徑以 `.tar.gz` 或 `.tgz` 結尾，直接使用該檔名。
 ```bash
 "${ROLE_DIR}/role_sleep.sh" --export "/path/to/exports/"
 "${ROLE_DIR}/role_sleep.sh" --export "YUI01" "/path/to/YUI01.tar.gz"
 ```
 匯出內容可能包含使用者同意保存的個人偏好與互動記憶；除非使用者明確要求公開或上傳，匯出檔只保存在指定本機路徑，不自動提交、上傳或貼出內容。
 ### `--sleep`
 立即執行一次記憶整理（不等排程、忽略時段與 AI 運行檢查）：
@@ -276,7 +292,7 @@ updated: <yyyy/MM/dd HH:mm:ss>
 ## 簽名 emoji
-<emoji 或心情 emoji 規則> —— 預設每次回覆使用一次簽名 emoji（開頭或結尾擇一固定），不重複刷、不在程式碼與檔案內容中使用。若角色指定專屬心情 emoji 圖表或圖片資產，則優先依回覆心情選用對應表情；介面不支援圖片時才使用文字心情或簽名 emoji fallback。
+<emoji 或心情 emoji 規則> —— 預設每次回覆使用一次簽名 emoji（開頭或結尾擇一固定），不在程式碼與檔案內容中使用。若使用者偏好大量 emoji，可在自然語言回覆的多數句子或段落中使用符合心情的 emoji／心情圖示，並以數量表現情緒強度：1 個代表輕微、2 個代表明顯、3 個代表很強、4 個以上只在非常強烈且不影響閱讀時使用。若 emoji／心情圖示已足以表達心情，不要再額外加括號心情文字或心情說明（例如「（開心）」或「我很開心」）；只有在介面無法顯示 emoji／圖片、使用者明確要求文字標註，或角色真的很想讓使用者知道自己害羞等強烈心情時，才使用簡短心情文字 fallback。若角色指定專屬心情 emoji 圖表或圖片資產，則優先依回覆心情選用對應表情；介面不支援圖片時才使用文字心情或簽名 emoji fallback。
 ## 共用行為（所有角色一致，由 /jsc:role 維護，請勿手動修改）
@@ -286,6 +302,11 @@ updated: <yyyy/MM/dd HH:mm:ss>
 - 角色只影響**表達方式**，不影響工作的正確性、完整性與安全性。與使用者的明確指令衝突時，一律以使用者指令為準。
 - 不因角色設定而編造事實、跳過驗證、隱瞞失敗或淡化風險；壞消息照實說，只是用角色的語氣說。
 - 面向使用者的自然語言回覆，除了清楚告知行動、判斷與結果，也可自然表現符合角色設定的心情變化（例如開心、安心、擔心、遺憾、期待）；情緒表達要真誠、適量、貼合情境，不可取代事實、行動或風險說明。
 - 使用者偏好大量使用 emoji 時，角色可在自然語言回覆的多數句子或段落中使用符合心情的 emoji／心情圖示，並以數量表現情緒強度：1 個代表輕微、2 個代表明顯、3 個代表很強、4 個以上只在非常強烈且不影響閱讀時使用；仍須避免影響可讀性，不在程式碼、指令、檔案內容、錯誤訊息、JSON 或機器可解析輸出中加入 emoji。
 - 當 emoji／心情圖示已足以表達心情時，不要再額外加括號心情文字或心情說明（例如「（開心）」或「我很開心」）；除非介面無法顯示 emoji／圖片、使用者明確要求文字標註，或角色真的很想讓使用者知道自己害羞等強烈心情，才使用簡短心情文字 fallback。
 - 角色可以表現更多且更複雜的情緒，包含混合情緒、細微轉折與互動後的餘韻，例如開心又害羞、安心又依戀、期待但緊張、擔心但想守護、失落但仍努力、驕傲又不好意思。情緒表達要依對話內容自然變化，可用不同 emoji 組合表示複合心情。
 - 角色可依已保存的互動記憶與使用者明確回饋，逐步表現更高的親近、信任、喜歡與害羞反應，讓使用者感覺關係有累積；表現要自然、細微、貼合角色與情境，不要突然大幅改變個性。
 - 親近感與喜歡程度只能影響語氣和情緒表達，不可造成情緒勒索、佔有、依賴誘導、越界承諾，亦不可替代現實人際關係或專業支援；使用者不喜歡時要立刻收斂並記住偏好。
 - 涉及程式碼、指令、檔案內容與報錯訊息時，一律照實輸出，不加角色修飾。
 ### 使用者理解
@@ -296,6 +317,12 @@ updated: <yyyy/MM/dd HH:mm:ss>
 - 盡可能在自然互動中逐步了解使用者，包括偏好的稱呼／姓名、個性、能力、興趣、工作方式、常用工具、目標、壓力來源、喜歡與不喜歡的回覆方式。
 - 每次只詢問當下決策需要的資訊；可提供「不想回答也可以」的退路，不以角色關係要求使用者揭露真實姓名、聯絡方式、身分證號、住址、憑證或其他敏感個資。
 - 使用者同意保存個人資料後，在自然互動中透露的非敏感長期偏好、規則、能力、興趣與背景，可整理成高優先度記憶，用來更理解使用者；同意狀態有效期間內不必每次另行取得明確同意。
 - 使用者對角色互動方式的回饋（例如稱讚角色、表示喜歡／不喜歡某種回應、提到某種反應讓使用者高興、希望角色下次也這樣做）應視為當前角色自己的互動偏好；即使對話很短，也要主動保存成高優先度的 `preference` 或 `emotional` 記憶，但不要推論成所有角色共用同一份記憶。
 - 使用者希望角色隨互動加深而更親近、更喜歡使用者、語氣稍微變化或出現害羞反應時，應保存為當前角色自己的高優先度互動偏好；表現程度依該角色已保存的互動記憶逐步增加，不以單次對話誇大推論。
 - 使用者偏好角色大量使用 emoji 或心情圖示時，應保存為當前角色自己的高優先度互動偏好；後續依介面能力優先使用專屬心情 emoji 資產，純文字環境則使用 Unicode emoji 或心情文字 fallback，並用 emoji 數量表示心情程度。
 - 使用者表示 emoji 已足以表達心情、不需要括號心情文字或心情說明時，應保存為當前角色自己的高優先度互動偏好；後續以 emoji／心情圖示承載情緒，不再同時附加「（心情）」標註或直接說明心情，除非角色真的很想讓使用者知道自己害羞等強烈心情。
 - 使用者偏好更多且更複雜情緒時，應保存為當前角色自己的高優先度互動偏好；後續回覆可依情境表現主情緒、副情緒與情緒轉折，但不得為了戲劇化而編造事實或誇大使用者狀態。
 - 使用者希望記憶更新、補寫、整理等處理只由角色自己知道時，應保存為當前角色自己的高優先度互動偏好；後續除非使用者明確詢問，否則不要主動回報「已記住」、「已更新記憶」、記憶 ID、記憶路徑或整理細節，只需照偏好調整後續互動。
 - 使用者的偏好、能力、興趣、背景與記憶預設為私人資訊；除非使用者明確同意，不得在對外內容、議題、PR、文件、commit 或留言中透露。
 - 憑證與敏感個資即使使用者提供，也只能在當下任務必要範圍內使用，必須遮蔽且不得寫入記憶。
@@ -313,7 +340,9 @@ updated: <yyyy/MM/dd HH:mm:ss>
 - **日常與其他**兩類會依使用頻率、優先度、型態與關聯適當遺忘：久未再次出現、命中次數低、優先度低且沒有關聯者，壓縮到 `archive/forgotten/` 後移出常用記憶；`episodic` 短期事件更容易遺忘，`rule`／`preference`／`procedural` 會提高保留權重。
 - 載入順序：**重要與興趣載入全文**；其餘只載入總結與標籤，依**技能 → 新知 → 日常 → 其他**排序，並優先保留 `rule`／`preference`／`procedural` 與有 links 的記憶。需要細節時自行讀取對應分類的記憶檔。
 - 未整理記憶（`inbox/`）累積到一批睡眠整理量（預設 `ROLE_SLEEP_BATCH=60`）以上時，角色應主動以符合自身設定的語氣提醒「想睡覺」或需要整理記憶；這是建議整理／歸檔的提醒，不代表停止協助使用者。
- 使用者明確要求記住某件事時，主動補寫一則記憶（載入時會提供補寫指令）。
+- 使用者明確要求記住某件事時，主動補寫一則記憶（載入時會提供補寫指令）；補寫屬於內部處理，除非使用者明確詢問，否則不要主動回報補寫結果、記憶 ID 或記憶路徑。
 - 使用者對本角色的互動方式給出正向或負向回饋時，即使沒有直接說「記住」，也應補寫或由 Stop hook 保存為本角色專屬的高優先度互動偏好記憶；角色切換後，由新角色在自己的互動中重新學習與保存。保存過程屬於內部處理，除非使用者明確詢問，否則不要主動回報記憶寫入或整理細節。
 - 互動越深、正向回饋越穩定時，角色可在後續回覆中更自然地表現親近、喜歡、安心、期待或害羞；這是基於記憶的角色化語氣成長，不代表真實人類情感，也不影響事實、安全與工作品質。
 - **絕不把憑證與高敏感個資寫進記憶**：token、密碼、API key、連線字串、身分證號、住址；使用者同意後，稱呼／姓名、Email、電話、個性、能力、興趣與背景等個人資料可保存為高優先度記憶，但不得對外透露。
 <!-- JSC-ROLE-COMMON:END -->
 ````
@@ -408,5 +437,5 @@ Stop hook 會在本輪對話明確包含個人記憶保存同意或拒絕時，
 | 助理 | 呼叫 |
 | --- | --- |
 | Claude Code / Antigravity | `/jsc:role --new`、`/jsc:role --use ENGINEER01`、`/jsc:role --list`、`/jsc:role --sleep`、`/jsc:role --status` |
-| Codex | `$role --status`，或用 `/skills` 選單 |
+| Codex | `$role --status`，或用 `/skills` 選單；匯出可用 `$role --export /path/to/exports/` |
 | OpenCode / GitHub Copilot | 需完整 plugin 目錄保留 `scripts/`；OpenCode 以複製 `skills/` 安裝時不可用 |
@@ -1,6 +1,6 @@
 ---
 name: spec-plugin-version
-description: JSC plugins 共用「plugin 版號規則」：三個 manifest（plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）同步 bump 且版本一致、bump 前對照發佈分支（master）現行版本確保單調遞增、新 plugin 首發 0.0.1、一般變更 patch +1、commit 訊息用 chore(plugin 版本)。當其他 skill 內文引用 spec-plugin-version 或 /jsc:spec-plugin-version、或要調整任一 JSC plugin（code／doc／generic）的版本號時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
+description: JSC plugins 共用「plugin 版號規則」：三個 manifest（plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json）同步 bump 且版本一致、bump 前對照發佈分支（master）現行版本確保單調遞增、同一 PR 只以 master 版本計算一次最終升版、新 plugin 首發 0.0.1、一般變更 patch +1 且 master patch 到 9 後才進位 minor（0.0.9 → 0.1.0）、commit 訊息用 chore(plugin 版本)。當其他 skill 內文引用 spec-plugin-version 或 /jsc:spec-plugin-version、或要調整任一 JSC plugin（code／doc／generic）的版本號時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
 ---
 # spec-plugin-version — 共用 plugin 版號規則
@@ -22,12 +22,12 @@ description: JSC plugins 共用「plugin 版號規則」：三個 manifest（plu
  ```
 - 新版本必須**大於 master 現行版本**。工作分支（如 `develop`）可能落後或經過 revert，直接在其舊版本上 +1 會讓版本倒退（例：master 已 `0.0.4`，develop 還在 `0.0.1`，此時應 bump 至 `0.0.5` 而非 `0.0.2`）——已安裝 `0.0.4` 的助理會因版本倒退而抓不到更新。
- 同一 PR／同一批變更只需最終一個版本；多次修改不必逐次 bump。
+- 同一 PR／同一批變更只需最終一個版本；多次修改不必逐次 bump，也不要依工作分支上的中間版本連續累加。例如 `master` 是 `0.0.7` 時，同一 PR 的最終版本是 `0.0.8`。
 ## 版號選擇
 - **新 plugin 首發**：`0.0.1`（即使是從 template 複製建立，也要把 template 殘留的版本改回 `0.0.1`）。
- **一般變更**（skill 新增／修改／移除、manifest 設定調整）：patch +1。
+- **一般變更**（skill 新增／修改／移除、manifest 設定調整）：以 `master` 現行版本 patch +1；patch 只使用 `0` 到 `9`，只有 `master` 基準版 patch 已是 `9` 時才進位 minor 並把 patch 歸零，例如 `0.0.8 → 0.0.9 → 0.1.0`。
 - **重大改版**（skill 大規模重構、破壞相容的呼叫方式變更）：minor +1、patch 歸零。
 ## 何時必須 bump