fix(plugin 版本): 以 master 計算 PR 最終升版

2026-07-28 16:13:41 +08:00
parent 131cda2978
commit 4c5e7034ff
2 changed files with 4 additions and 4 deletions
@@ -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 且 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。單獨被使用者呼叫時，直接說明本規範內容。
+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；patch 只使用 `0` 到 `9`，超過 `9` 時進位 minor 並把 patch 歸零，例如 `0.0.8 → 0.0.9 → 0.1.0`。
+- **一般變更**（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