release: v0.1.6 develop 到 master #27

2026-08-27T09:00:06Z

jiantw83 commented

2026-08-27 09:00:06 +00:00

摘要

需求描述：把 jsc-gitea 0.1.6 從 develop 放行到 master，共 6 個 commit。內容是使用者 15 條工作規則的第三群「技能組治理」在本存取庫的落地：wiki 新增 SKILLSET 頁型（技能組異動報告，頁內累積歷次異動），以及對應的專用環境變數 JSC_WIKI_REPO_SKILLSET。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`tools/gitea.sh`	`wiki-repo` 支援 `SKILLSET` 頁型，解析順序照既有規則：先 `JSC_WIKI_REPO_SKILLSET`，再退回共用的 `JSC_WIKI_REPO`。
`skills/wiki/SKILL.md`	頁型清單納入 `SKILLSET`，讓技能知道有這個頁型可以寫。
`tools/check-wiki-rules.sh`	頁型驗證涵蓋 `SKILLSET`，說明改為不綁類型數量，以後加頁型不必再回來改這句。
`README.md`	補上 `SKILLSET` 頁型與專用環境變數。
`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`	三份 manifest 同步升版到 0.1.6。

設計重點

這一段才是讓已安裝的 CLI 抓到新內容的那一段。develop 併了不等於生效：marketplace 與 jsc-hooks/hooks/version-guard.sh 讀的都是存取庫的預設分支 master。version-guard.sh 取 raw plugin.json 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 master，五支 CLI 才看得到 0.1.6。
SKILLSET 是累積型頁面，不是每次異動開一頁。技能組的異動要能一頁看完歷次變化，才看得出哪些規則反覆在改。
專用變數優先、共用變數墊底，跟其他頁型同一套解析順序，沒有為新頁型另立規矩。
跨類型不代用：拿 SKILLSET 去要別的類型的存取庫會回 exit 3，不會靜靜給錯的存取庫。
驗證腳本的說明刻意不寫「支援 N 種頁型」。寫了數字，下次加頁型就多一個會忘記改的地方。

升級後使用者會立刻感受到的差異

多一個可用的 wiki 頁型 SKILLSET，jsc-meta 的四支異動技能會在收尾寫 SKILLSET_{HASH} 報告（見 jsc-meta 0.1.4 的放行 PR）。
想把技能組異動報告放到另一個 wiki 存取庫的人，可以只設 JSC_WIKI_REPO_SKILLSET，不影響其他頁型。

測試結果

ste100-lint.sh 掃本存取庫全綠。
三份 manifest 版本一致為 0.1.6。
gitea.sh wiki-repo SKILLSET 四種情境都與預期相同：專用變數 JSC_WIKI_REPO_SKILLSET 優先、只設共用變數時退回 JSC_WIKI_REPO、給假頁型回 exit 2、跨類型不代用回 exit 3。
本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#25）與主幹 PR（#26）階段跑的，這個 PR 只是把已驗證的 develop 內容推到預設分支。

前置 Push Request

無

## 摘要 - 需求描述：把 jsc-gitea 0.1.6 從 `develop` 放行到 `master`，共 6 個 commit。內容是使用者 15 條工作規則的第三群「技能組治理」在本存取庫的落地：wiki 新增 `SKILLSET` 頁型（技能組異動報告，頁內累積歷次異動），以及對應的專用環境變數 `JSC_WIKI_REPO_SKILLSET`。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `tools/gitea.sh` | `wiki-repo` 支援 `SKILLSET` 頁型，解析順序照既有規則：先 `JSC_WIKI_REPO_SKILLSET`，再退回共用的 `JSC_WIKI_REPO`。 | | `skills/wiki/SKILL.md` | 頁型清單納入 `SKILLSET`，讓技能知道有這個頁型可以寫。 | | `tools/check-wiki-rules.sh` | 頁型驗證涵蓋 `SKILLSET`，說明改為不綁類型數量，以後加頁型不必再回來改這句。 | | `README.md` | 補上 `SKILLSET` 頁型與專用環境變數。 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 三份 manifest 同步升版到 0.1.6。 | ## 設計重點 - 這一段才是讓已安裝的 CLI 抓到新內容的那一段。`develop` 併了不等於生效：marketplace 與 `jsc-hooks/hooks/version-guard.sh` 讀的都是存取庫的**預設分支** `master`。`version-guard.sh` 取 raw `plugin.json` 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 `master`，五支 CLI 才看得到 0.1.6。 - `SKILLSET` 是累積型頁面，不是每次異動開一頁。技能組的異動要能一頁看完歷次變化，才看得出哪些規則反覆在改。 - 專用變數優先、共用變數墊底，跟其他頁型同一套解析順序，沒有為新頁型另立規矩。 - 跨類型不代用：拿 `SKILLSET` 去要別的類型的存取庫會回 exit 3，不會靜靜給錯的存取庫。 - 驗證腳本的說明刻意不寫「支援 N 種頁型」。寫了數字，下次加頁型就多一個會忘記改的地方。 ## 升級後使用者會立刻感受到的差異 - 多一個可用的 wiki 頁型 `SKILLSET`，jsc-meta 的四支異動技能會在收尾寫 `SKILLSET_{HASH}` 報告（見 jsc-meta 0.1.4 的放行 PR）。 - 想把技能組異動報告放到另一個 wiki 存取庫的人，可以只設 `JSC_WIKI_REPO_SKILLSET`，不影響其他頁型。 ## 測試結果 - `ste100-lint.sh` 掃本存取庫全綠。 - 三份 manifest 版本一致為 0.1.6。 - `gitea.sh wiki-repo SKILLSET` 四種情境都與預期相同：專用變數 `JSC_WIKI_REPO_SKILLSET` 優先、只設共用變數時退回 `JSC_WIKI_REPO`、給假頁型回 exit 2、跨類型不代用回 exit 3。 - 本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#25）與主幹 PR（#26）階段跑的，這個 PR 只是把已驗證的 `develop` 內容推到預設分支。 ## 前置 Push Request - 無

jiantw83 added 6 commits 2026-08-27 09:00:06 +00:00

feat(wiki): 支援 SKILLSET 頁面類型 920c68087e

What：`tools/gitea.sh` 的 `resolve_wiki_repo()` 允許清單加入 `SKILLSET`，`wiki-repo` 的用法註解同步。`skills/wiki/SKILL.md` 第 2 步的允許頁型補上 `SKILLSET`，同時補上先前漏列的 `CHECK` 與 `REPORT`；`description` 的呼叫端清單補上「`jsc-meta` 的 `SKILLSET` 頁」。

Why：`jsc-meta` 的四支異動技能收尾要把驗證結果寫進 `SKILLSET_{HASH}`，而所有 wiki 讀寫都走這一支技能與這一支腳本。頁型不在允許清單裡，`wiki-repo` 會直接 exit 2，報告一個字也寫不進去。`CHECK` 與 `REPORT` 是另一件事：腳本早就支援，技能的允許清單卻沒補，照技能寫的走會以為那兩種頁型不合法。

How：只加類型名，解析規則不動——`JSC_WIKI_REPO_SKILLSET` 優先，未設定才退回 `JSC_WIKI_REPO`，不做跨類型代用，兩個都沒有仍是 exit 3 交回技能問使用者。雜湊來源是被改動的 domain 存取庫 `{owner}/{repo}`，用的是同一支 `hash-id`，所以這裡不必為它多寫一條特例（`CHECK` 那種主機加帳號的例外才需要）。

Who：`jsc-gitea:wiki` 技能與 `jsc-meta` 四支異動技能的異動報告寫入路徑。

test(check-wiki-rules): 頁型驗證涵蓋 SKILLSET，說明改為不綁類型數量 653d54476b

What：`tools/check-wiki-rules.sh` 的 `TYPES` 加入 `SKILLSET`，檔頭的「涵蓋全部十一種頁面類型」改成「涵蓋 `TYPES` 列的每一種頁面類型」，誘餌值那段註解的「其他八個類型」改成「其餘每一個類型」。

Why：驗證清單沒跟上，新頁型的三項判定（專用變數優先、退回共用變數、不得跨類型代用）就一次都沒驗到。註解裡寫死數字更麻煩：每加一種頁型就要記得改兩個數字，忘了改註解就開始騙人——事實上加 `CHECK` 與 `REPORT` 那次就已經漏了一個。

How：只加 `TYPES` 一個字串，三項判定與誘餌值都是照 `TYPES` 展開的，加進去就自動涵蓋，不必另外寫測項。註解一律改成指向 `TYPES` 這個變數，不再寫死數量，日後加頁型只要改一個地方。

Who：`jsc-gitea` 的 wiki 頁型解析驗證，以及日後新增頁面類型的人。

docs(gitea): README 補上 SKILLSET 頁型與專用環境變數 c3b46c982f

What：`README.md` 兩處增修。`wiki-repo` 的用法說明把允許的 `TYPE` 清單補到十二種（加上 `CHECK`、`REPORT`、`SKILLSET`）；環境變數表新增 `JSC_WIKI_REPO_SKILLSET` 一列，寫明對應 `SKILLSET_CONTENTS`、`SKILLSET_{HASH}`（技能組異動報告）與雜湊來源 `{owner}/{repo}`。

Why：README 的類型清單停在九種，`CHECK` 與 `REPORT` 支援了卻沒補上。照 README 設定環境變數的人會以為這幾種頁型沒有專用變數，只能全塞進共用的 `JSC_WIKI_REPO`。

How：`SKILLSET` 單獨列一列而不是併進 `JSC_WIKI_REPO_{TYPE}` 那一行，因為它要多寫雜湊來源；`JSC_WIKI_REPO_{TYPE}` 那一行只補清單，退回規則不動，兩列都保留「不做跨類型代用」這句。

Who：讀 `jsc-gitea` 說明設定 wiki 位置的操作者。

chore(manifest): 三份 manifest 版本升到 0.1.6 1db01ca0f1

What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.5 改為 0.1.6。

Why：本次 `wiki-repo` 多支援一種頁面類型，`wiki` 技能的允許頁型也跟著補齊，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。

How：三份只改 `version` 一個欄位，其餘內容不動，三份保持同一版號。

Who：`jsc-gitea` 外掛的套件描述檔。

Merge pull request 'feat(gitea): 支援 SKILLSET 頁面類型' (#25 ) from feat/skillset-governance/wiki-skillset-type into feat/skillset-governance/main a5b5d7362c

Reviewed-on: #25

Merge pull request 'feat(gitea): wiki 支援 SKILLSET 技能組異動報告頁型' (#26 ) from feat/skillset-governance/main into develop 8483f8d1bb

Reviewed-on: #26

admin approved these changes 2026-08-27 09:00:55 +00:00

admin merged commit 980c1e98ec into master

2026-08-27 09:01:00 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/gitea#27