sync #14

Merged
admin merged 16 commits from master into develop 2026-07-28 08:16:42 +00:00
2 changed files with 4 additions and 4 deletions
Showing only changes of commit 4c5e7034ff - Show all commits
+1 -1
View File
@@ -208,7 +208,7 @@ copilot plugin marketplace remove generic
| `spec-dockerfile` | Dockerfile | 六步流程(參數→安裝→複製→執行→縮小→入口)、多階段建置、固定版號、對外契約不動、自我檢查 | | `spec-dockerfile` | Dockerfile | 六步流程(參數→安裝→複製→執行→縮小→入口)、多階段建置、固定版號、對外契約不動、自我檢查 |
| `spec-project-board` | Gitea 看板 | 進度欄位語意對應、建議欄位規則、GET 探測(404/501 不支援)、不往回移、不得新建欄位 | | `spec-project-board` | Gitea 看板 | 進度欄位語意對應、建議欄位規則、GET 探測(404/501 不支援)、不往回移、不得新建欄位 |
| `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 | | `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 |
| `spec-plugin-version` | 版號規則 | 三 manifest 同步 bump、對照 master 確保單調遞增、新 plugin 首發 0.0.1、patch 到 9 後進位 minor、chore(plugin 版本) commit | | `spec-plugin-version` | 版號規則 | 三 manifest 同步 bump、 master 為基準計算同一 PR 的最終版本、新 plugin 首發 0.0.1、patch 到 9 後進位 minor、chore(plugin 版本) commit |
### 角色與記憶 ### 角色與記憶
+3 -3
View File
@@ -1,6 +1,6 @@
--- ---
name: spec-plugin-version name: spec-plugin-version
description: JSC plugins 共用「plugin 版號規則」:三個 manifestplugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json)同步 bump 且版本一致、bump 前對照發佈分支(master)現行版本確保單調遞增、新 plugin 首發 0.0.1、一般變更 patch +1 且 patch 到 9 後進位 minor0.0.9 → 0.1.0)、commit 訊息用 chore(plugin 版本)。當其他 skill 內文引用 spec-plugin-version 或 /jsc:spec-plugin-version、或要調整任一 JSC plugincodedocgeneric)的版本號時載入此 skill。單獨被使用者呼叫時,直接說明本規範內容。 description: JSC plugins 共用「plugin 版號規則」:三個 manifestplugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json)同步 bump 且版本一致、bump 前對照發佈分支(master)現行版本確保單調遞增、同一 PR 只以 master 版本計算一次最終升版、新 plugin 首發 0.0.1、一般變更 patch +1 且 master patch 到 9 後進位 minor0.0.9 → 0.1.0)、commit 訊息用 chore(plugin 版本)。當其他 skill 內文引用 spec-plugin-version 或 /jsc:spec-plugin-version、或要調整任一 JSC plugincodedocgeneric)的版本號時載入此 skill。單獨被使用者呼叫時,直接說明本規範內容。
--- ---
# spec-plugin-version — 共用 plugin 版號規則 # spec-plugin-version — 共用 plugin 版號規則
@@ -22,12 +22,12 @@ description: JSC plugins 共用「plugin 版號規則」:三個 manifestplu
``` ```
- 新版本必須**大於 master 現行版本**。工作分支(如 `develop`)可能落後或經過 revert,直接在其舊版本上 +1 會讓版本倒退(例:master 已 `0.0.4`develop 還在 `0.0.1`,此時應 bump 至 `0.0.5` 而非 `0.0.2`)——已安裝 `0.0.4` 的助理會因版本倒退而抓不到更新。 - 新版本必須**大於 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`)。 - **新 plugin 首發**`0.0.1`(即使是從 template 複製建立,也要把 template 殘留的版本改回 `0.0.1`)。
- **一般變更**(skill 新增/修改/移除、manifest 設定調整):patch +1patch 只使用 `0` 到 `9`超過 `9` 時進位 minor 並把 patch 歸零,例如 `0.0.8 → 0.0.9 → 0.1.0`。 - **一般變更**(skill 新增/修改/移除、manifest 設定調整):以 `master` 現行版本 patch +1patch 只使用 `0` 到 `9`只有 `master` 基準版 patch 已是 `9` 時進位 minor 並把 patch 歸零,例如 `0.0.8 → 0.0.9 → 0.1.0`。
- **重大改版**(skill 大規模重構、破壞相容的呼叫方式變更):minor +1、patch 歸零。 - **重大改版**(skill 大規模重構、破壞相容的呼叫方式變更):minor +1、patch 歸零。
## 何時必須 bump ## 何時必須 bump