收攏行為清單檢查腳本與準則改寫，功能主幹併回 develop #48

2026-08-31T06:37:14Z

jiantw83 commented

2026-08-31 06:37:14 +00:00

摘要

需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 feat/skill-behaviors-and-version-block/main，再由本 PR 一次併回 develop。本輪功能是新增 tools/check-behaviors.sh 與自己的行為清單、改寫 references/guidelines.md 的相依版本準則、更新 5 支技能文件。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
由子功能 PR 帶入	本 PR 自身不提交檔案。內容來自 plugins/meta#47，該 PR 併入功能主幹後才會出現在這裡

設計重點

走完整階梯。子功能分支先併入功能主幹，功能主幹再併回 develop，中間不跳級。
功能主幹目前與 develop 指向同一個 commit，所以本 PR 剛開時的變更檔案數是 0。這是預期結果，不是開錯 base。plugins/meta#47 併入功能主幹之後，內容才會浮現在本 PR。
功能主幹集中審查。同一輪功能的子功能分支併攏後，develop 只收一次。

測試結果

本 PR 不含自身提交，測試結果以子功能 PR plugins/meta#47 為準。該 PR 跑過 check-behaviors.sh，結束碼 0，清單對上 7 支技能；lint-scripts.sh 結束碼 0，12 支腳本全過。

前置 Push Request

plugins/meta#47：#47

## 摘要 - 需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 `feat/skill-behaviors-and-version-block/main`，再由本 PR 一次併回 `develop`。本輪功能是新增 `tools/check-behaviors.sh` 與自己的行為清單、改寫 `references/guidelines.md` 的相依版本準則、更新 5 支技能文件。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | 由子功能 PR 帶入 | 本 PR 自身不提交檔案。內容來自 plugins/meta#47，該 PR 併入功能主幹後才會出現在這裡 | ## 設計重點 - 走完整階梯。子功能分支先併入功能主幹，功能主幹再併回 `develop`，中間不跳級。 - 功能主幹目前與 `develop` 指向同一個 commit，所以本 PR 剛開時的變更檔案數是 0。這是預期結果，不是開錯 base。plugins/meta#47 併入功能主幹之後，內容才會浮現在本 PR。 - 功能主幹集中審查。同一輪功能的子功能分支併攏後，`develop` 只收一次。 ## 測試結果 - 本 PR 不含自身提交，測試結果以子功能 PR plugins/meta#47 為準。該 PR 跑過 `check-behaviors.sh`，結束碼 0，清單對上 7 支技能；`lint-scripts.sh` 結束碼 0，12 支腳本全過。 ## 前置 Push Request - plugins/meta#47：https://gitea.jsc.idv.tw/plugins/meta/pulls/47

jiantw83 added a new dependency 2026-08-31 06:37:35 +00:00

#47 新增行為清單檢查腳本，改寫相依版本準則並更新 5 支技能

jiantw83 added 4 commits 2026-08-31 08:09:25 +00:00

feat(behaviors): 新增技能行為清單與檢查腳本 2e237b7674

What：新增 references/behaviors.md，一支技能一節，共七支技能。每節五列，記下觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。新增 tools/check-behaviors.sh，比對 skills/ 與這份清單。skill-new、skill-update、skill-delete、skillset-update 加上同步更新清單的步驟。skill-check 把這支腳本併進第一組稽核。

Why：技能驗證原本沒有基準，稽核只能靠眼睛比對 SKILL.md。十個 domain 每輪都要重做一遍，還會漏掉。行為清單當基準，技能改了、清單沒跟著改，就是漂移。漂移交給程式判定才穩。

How：腳本檢查節數、節名、節序、每節一張表、五個欄位齊全、內容欄非空。退出碼 0 代表相符，1 代表不符，2 代表用法錯誤，3 代表找不到清單或找不到 skills 目錄。domain 名以 plugin.json 的 name 為準，checkout 目錄名只是退路。四支異動技能在同一個 PR 內改清單，並照退出碼分流。

Who：屬於「技能行為清單」這件需求，提供技能驗證的參考基準。

docs(guidelines): 改寫相依版本準則並補上技能行為清單合約 651dc19be9

What：「Manifest 相依版本」第 5 條改成部署端照樣更新，只在回報裡寫明缺哪一版。「版本前置檢查」補上相依版本檢查三列。新增「技能行為清單」一節，訂出位置、標題、節、表格、欄位與更新時機。審核檢查清單加上行為清單這一項。README 補上 behaviors.md 與 check-behaviors.sh 兩列，並把 skill-check 段落改成三組腳本。

Why：跳過更新會讓落後的 domain 永遠更新不到。它落後所以被跳過，被跳過所以永遠落後。相依版本不符要擋的是拿舊版去跑，不是把舊版換成新版。阻擋改到技能被呼叫的當下，才擋得住真正會出事的動作。行為清單要有一份格式合約，check-behaviors.sh 才有判定依據。

How：阻擋交給 jsc-hooks/hooks/version-guard.sh。版本比對由它自己實作，不呼叫 jsc-cli/tools/check-requires.sh。hook 專屬存放於 jsc-hooks，而且 jsc-cli 已宣告相依 jsc-hooks，反向呼叫會做出循環相依。兩道檢查共用同一份豁免清單。行為清單一個 domain 一份，放進該 domain 的 references/behaviors.md，技能改動與清單改動才進得了同一個 PR。

Who：涵蓋這次兩件需求的準則與說明文件，一件是相依版本不符改為阻擋執行，一件是技能行為清單。

chore(manifest): 同步三份 manifest 的版本到 0.2.4 f5f2cb05bd

What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 的 version 從 0.2.3 提升到 0.2.4。

Why：這次新增了行為清單與檢查腳本，也改了五支技能的內文。版本不提升，version-guard.sh 就比不出遠端已經有新版，部署端也拿不到更新提示。

How：三份 manifest 只改 version 一個欄位，三份的值保持一致，其餘欄位原樣保留。

Who：收尾這次技能行為清單與相依版本阻擋兩件需求，對應審核檢查清單的 manifest 同步項。

Merge pull request '新增行為清單檢查腳本，改寫相依版本準則並更新 5 支技能' (#47 ) from feat/skill-behaviors-and-version-block/behavior-list-check-and-guidelines into feat/skill-behaviors-and-version-block/main 9ed26de7ba

jiantw83 merged commit 1cfd727436 into develop

2026-08-31 08:10:38 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Depends on

#47 新增行為清單檢查腳本，改寫相依版本準則並更新 5 支技能

plugins/meta

Reference: plugins/meta#48