plugins/meta
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: v0.1.4 develop 到 master #27

Merged
admin merged 6 commits from develop into master 2026-08-27 09:01:14 +00:00
Conversation 1 Commits 6 Files Changed 9
+91 -10
jiantw83 commented 2026-08-27 09:00:07 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 jsc-meta 0.1.4 從 develop 放行到 master，共 6 個 commit。內容是使用者 15 條工作規則的第三群「技能組治理」在本存取庫的落地：guidelines.md 新增 SKILLSET 頁型、兩個環境變數、部署後重啟閘門一節與稽核流程檢查四項；skill-check 加上 marketplace 同步必經步驟；四支異動技能收尾加上套用、驗證與寫異動報告。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
references/guidelines.md 新增 SKILLSET 頁型、JSC_WIKI_REPO_SKILLSET 與 JSC_RESTART_GATE；新增「部署後重啟閘門」一節，含九支豁免技能的對照表；稽核清單加流程檢查四項：指標指得到、每步有完成條件、退路與失敗分流、閘門不自鎖。
skills/skill-check/SKILL.md 稽核流程加上 marketplace 同步必經步驟，並納入新的流程檢查四項。同步不做就會拿舊的技能清單去稽核。
skills/skill-new/SKILL.md、skills/skill-update/SKILL.md、skills/skill-delete/SKILL.md、skills/skillset-update/SKILL.md 四支異動技能收尾統一加三步：套用到當前工作階段、驗證有生效、寫 SKILLSET_{HASH} 異動報告。
plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份 manifest 同步升版到 0.1.4。

設計重點

  • 這一段才是讓已安裝的 CLI 抓到新內容的那一段。develop 併了不等於生效：marketplace 與 jsc-hooks/hooks/version-guard.sh 讀的都是存取庫的預設分支 master。version-guard.sh 取 raw plugin.json 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 master，五支 CLI 才看得到 0.1.4。本存取庫同時是 marketplace 正本，這一段沒進 master，其他五個網域的新版也不會被找到。
  • 流程檢查四項都是可指認的，不是主觀評語。指標指得到就是連結能開、完成條件就是有沒有寫清楚何時算完、退路就是失敗要往哪走、閘門不自鎖就是被擋的人有路解除。
  • 「閘門不自鎖」寫進準則，是因為這一批本來就加了一道閘門。規則跟自己的產物同一批進來，才不會出現準則管不到最新功能的空窗。
  • 四支異動技能的收尾統一加同三步。異動技能改完技能組卻不套用、不驗證，等於改在紙上；不寫報告，下次就沒有歷史可查。
  • marketplace 同步列為必經步驟而不是建議。這是稽核結論正確性的前提，不是加分項。

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

  • 稽核會多抓四類流程問題：指標指不到、步驟沒有完成條件、缺退路與失敗分流、閘門會自鎖。原本會過的技能，這版可能被指出來。
  • 四支異動技能跑完會多三步收尾，並在 wiki 留下 SKILLSET_{HASH} 異動報告。
  • 準則文件裡可以查到九支豁免技能的完整對照表，被重啟閘門擋住時不必去翻 hook 原始碼。

測試結果

  • ste100-lint.sh 掃本存取庫全綠，另以本存取庫的 tools/ste100-lint.sh 掃過其餘五個網域存取庫，六個全綠。
  • 三份 manifest 版本一致為 0.1.4。
  • 準則裡的九支豁免技能對照表與 jsc-hooks restart-gate.sh 的實作、skills/hooks-install/SKILL.md 的清單三方一致。
  • 沒跑的部分據實說明：本存取庫這一段只改準則與技能文件，沒有新增或修改腳本，所以沒有本存取庫專屬的腳本測試可跑。這一批的腳本測試在 jsc-review、jsc-hooks、jsc-cli、jsc-gitea 四個存取庫的放行 PR 裡。
  • 本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#25）與主幹 PR（#26）階段跑的，這個 PR 只是把已驗證的 develop 內容推到預設分支。

前置 Push Request

  • 無
## 摘要 - 需求描述：把 jsc-meta 0.1.4 從 `develop` 放行到 `master`，共 6 個 commit。內容是使用者 15 條工作規則的第三群「技能組治理」在本存取庫的落地：`guidelines.md` 新增 `SKILLSET` 頁型、兩個環境變數、部署後重啟閘門一節與稽核流程檢查四項；`skill-check` 加上 marketplace 同步必經步驟；四支異動技能收尾加上套用、驗證與寫異動報告。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/guidelines.md` | 新增 `SKILLSET` 頁型、`JSC_WIKI_REPO_SKILLSET` 與 `JSC_RESTART_GATE`；新增「部署後重啟閘門」一節，含九支豁免技能的對照表；稽核清單加流程檢查四項：指標指得到、每步有完成條件、退路與失敗分流、閘門不自鎖。 | | `skills/skill-check/SKILL.md` | 稽核流程加上 marketplace 同步必經步驟，並納入新的流程檢查四項。同步不做就會拿舊的技能清單去稽核。 | | `skills/skill-new/SKILL.md`、`skills/skill-update/SKILL.md`、`skills/skill-delete/SKILL.md`、`skills/skillset-update/SKILL.md` | 四支異動技能收尾統一加三步：套用到當前工作階段、驗證有生效、寫 `SKILLSET_{HASH}` 異動報告。 | | `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` | 三份 manifest 同步升版到 0.1.4。 | ## 設計重點 - 這一段才是讓已安裝的 CLI 抓到新內容的那一段。`develop` 併了不等於生效：marketplace 與 `jsc-hooks/hooks/version-guard.sh` 讀的都是存取庫的**預設分支** `master`。`version-guard.sh` 取 raw `plugin.json` 時刻意不指定 ref，Gitea 就回預設分支那一份，所以只有這個 PR 合進 `master`，五支 CLI 才看得到 0.1.4。本存取庫同時是 marketplace 正本，這一段沒進 `master`，其他五個網域的新版也不會被找到。 - 流程檢查四項都是可指認的，不是主觀評語。指標指得到就是連結能開、完成條件就是有沒有寫清楚何時算完、退路就是失敗要往哪走、閘門不自鎖就是被擋的人有路解除。 - 「閘門不自鎖」寫進準則，是因為這一批本來就加了一道閘門。規則跟自己的產物同一批進來，才不會出現準則管不到最新功能的空窗。 - 四支異動技能的收尾統一加同三步。異動技能改完技能組卻不套用、不驗證，等於改在紙上；不寫報告，下次就沒有歷史可查。 - marketplace 同步列為必經步驟而不是建議。這是稽核結論正確性的前提，不是加分項。 ## 升級後使用者會立刻感受到的差異 - 稽核會多抓四類流程問題：指標指不到、步驟沒有完成條件、缺退路與失敗分流、閘門會自鎖。原本會過的技能，這版可能被指出來。 - 四支異動技能跑完會多三步收尾，並在 wiki 留下 `SKILLSET_{HASH}` 異動報告。 - 準則文件裡可以查到九支豁免技能的完整對照表，被重啟閘門擋住時不必去翻 hook 原始碼。 ## 測試結果 - `ste100-lint.sh` 掃本存取庫全綠，另以本存取庫的 `tools/ste100-lint.sh` 掃過其餘五個網域存取庫，六個全綠。 - 三份 manifest 版本一致為 0.1.4。 - 準則裡的九支豁免技能對照表與 jsc-hooks `restart-gate.sh` 的實作、`skills/hooks-install/SKILL.md` 的清單三方一致。 - 沒跑的部分據實說明：本存取庫這一段只改準則與技能文件，沒有新增或修改腳本，所以沒有本存取庫專屬的腳本測試可跑。這一批的腳本測試在 jsc-review、jsc-hooks、jsc-cli、jsc-gitea 四個存取庫的放行 PR 裡。 - 本次放行本身沒有重跑腳本測試。上列測試是在子功能 PR（#25）與主幹 PR（#26）階段跑的，這個 PR 只是把已驗證的 `develop` 內容推到預設分支。 ## 前置 Push Request - 無
jiantw83 added 6 commits 2026-08-27 09:00:07 +00:00
docs(guidelines): 準則新增 SKILLSET 頁型、部署後重啟閘門與流程檢查四項 6447416c7b 
What：`references/guidelines.md` 四處增修。環境變數表新增 `JSC_WIKI_REPO_SKILLSET` 與 `JSC_RESTART_GATE` 兩列；wiki 頁命名總表新增 `SKILLSET` 一列，並補上雜湊來源為被改動的 domain 存取庫 `{owner}/{repo}`、頁內累積歷次異動兩段說明；新增「部署後重啟閘門」一節，用表寫下狀態檔、清除時機、判定位置與逃生門，另附九支豁免技能的表與「清單認的是技能名，不是呼叫鏈」一段；審核檢查清單末尾新增流程檢查四項。

Why：這批規則要落到四個 domain 的腳本與技能裡，準則是它們的唯一真實來源。規則只留在各自的實作裡，改一邊忘一邊，稽核就沒有對照標準。三件事各有各的理由：`SKILLSET` 頁型讓技能組每次異動留下查得到的驗證紀錄；重啟閘門補上「部署換掉的是磁碟上的技能檔，工作階段載入的還是舊版」這段落差；流程檢查四項把過去踩過的坑寫成逐項確認得出來的項目。

How：閘門那一節刻意把每一支的「為什麼不能擋」逐支寫出來，不只列技能名——豁免清單日後要增刪，理由沒寫下來就得重新想一次。九支的理由收斂成同一件事：部署後還要寫得完技能組異動報告與工作日誌，整批擋下去「先重啟」與「先寫完報告」會互相打死，通則另外寫進流程檢查第 4 項「閘門不自鎖」。「清單認技能名不認呼叫鏈」單獨寫一段，因為後三支（`jsc-ask:ask`、`jsc-git:pr`、`jsc-git:commit`）自己不是收尾規則的主體，是為了讓前六支走得完才補進來的，日後增豁免時要一併想它會呼叫誰。流程檢查其中兩項附上踩過的實例，抽象敘述判不出來的，看實例就判得出來。

Who：`jsc-meta` 的技能準則，以及依準則稽核的 `skill-check` 與四支技能組異動技能。
feat(skill-check): 稽核加入 marketplace 同步必經步驟與流程檢查四項 9a0ea8e248 
What：`skills/skill-check/SKILL.md` 兩處增修。第 2 步的稽核範圍明寫要逐項涵蓋準則的流程檢查四項，四項各列一條，完成條件改成「每個 domain 的稽核結果對所有清單項目都有結論，含這四項」；新增第 5 步「同步 marketplace 正本」，四個結束碼各自寫明怎麼處理，原本的複查與開 PR 順延為第 6、7 步。

Why：`sync-marketplace.sh` 原本沒有出現在任何技能流程裡，跑不跑全憑人記得。正本在 `plugins/meta`，每個 domain 存取庫各留一份位元組完全相同的副本，稽核改完不同步，就會有存取庫註冊到過期的 plugin 清單。流程檢查四項同理：準則加了項目，稽核不點名就沒有人會查，四項等於沒加。

How：同步列為必經步驟，不是選項。呼叫時拿既有項目自己現在的值重寫一次，重寫同一筆是冪等的，所以不必先判斷哪一筆該改。四個結束碼逐一分流：3 是寫好了但有 domain 沒 clone 到本機，先跑 `sync-domains.sh` 再重跑；2 是參數個數不對；1 是缺 python3、正本讀不到或副本位元組不一致；0 才代表每份副本完全相同，而且是腳本自己驗過的。

Who：`jsc-meta:skill-check` 的例行合規稽核流程。
feat(skillset-report): 四支異動技能收尾套用到工作階段、驗證並寫異動報告 478f670d53 
What：`skill-new`、`skill-update`、`skill-delete`、`skillset-update` 四支各新增一個收尾步驟，內含三個子步驟：把改動套用到目前工作階段、逐項驗證功能真的動得起來、把驗證結果附加到 wiki 的 `SKILLSET_{HASH}`。四支的 `description` 同步補上這段收尾。

Why：原本四支都以「開了 PR」作為收尾。PR 開完技能還沒進到任何 CLI，改動到底動不動得起來沒人驗過，壞了要等下一次有人踩到才知道。技能組的異動紀錄也一樣沒有落腳處：同一支技能改過幾次、每次改了什麼，只能翻 git 紀錄。

How：套用那一步分兩條路徑，依改動走到哪裡決定。PR 已經合併到 `master` 才走 `jsc-cli:deploy` 更新模式，並依提示重新啟動；PR 還停在 `develop` 或還在等審核，就改用工作樹驗證，報告標成「工作樹驗證、尚未部署」，並點名還沒合併的發佈 PR。分兩條路徑的理由是完成條件達不到：marketplace 與 `version-guard.sh` 都讀存取庫的預設分支，停在 `develop` 的改動 `deploy` 一定看不到，硬跑就卡在永遠達不到的完成條件上。驗證那一步要求逐項比對結束碼與實際輸出，不接受「跑完沒報錯」；對不上就回到套用那一步重跑，不往下走。報告一律附加一節、不覆蓋舊節，要看一支技能改過幾次就在同一頁上翻；寫不進去就把頁名與未寫入的內容交回使用者，這一步留著不結案。

Who：`jsc-meta` 的四支技能組異動技能，以及日後查技能組異動紀錄的人。
chore(manifest): 三份 manifest 版本升到 0.1.4 816fe07fbd 
What：`plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 的 `version` 由 0.1.3 改為 0.1.4。

Why：本次準則新增 `SKILLSET` 頁型、部署後重啟閘門與流程檢查四項，`skill-check` 多了 marketplace 同步必經步驟，四支異動技能也多了收尾步驟，屬於行為變更，版本要跟著往上走，各 CLI 才知道要更新。

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

Who：`jsc-meta` 外掛的套件描述檔。
Merge pull request 'feat(meta): 新增 SKILLSET 頁型與稽核流程檢查，四支異動技能收尾寫異動報告' (#25) from feat/skillset-governance/page-type-and-process-audit into feat/skillset-governance/main 0ce64ba392 
Reviewed-on: #25
Merge pull request 'feat(meta): 新增 SKILLSET 頁型與部署後重啟閘門準則，稽核加流程檢查四項' (#26) from feat/skillset-governance/main into develop a65f546911 
Reviewed-on: #26
admin approved these changes 2026-08-27 09:01:11 +00:00
admin merged commit b1d39e7ac5 into master 2026-08-27 09:01:14 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/meta#27