 jiantw83
|
1cfd727436
|
Merge pull request '收攏行為清單檢查腳本與準則改寫，功能主幹併回 develop' (#48) from feat/skill-behaviors-and-version-block/main into develop
|
2026-08-31 08:10:37 +00:00 |
|
|
jiantw83
|
9ed26de7ba
|
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
|
2026-08-31 08:09:24 +00:00 |
|
|
jiantw83
|
f5f2cb05bd
|
chore(manifest): 同步三份 manifest 的版本到 0.2.4
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 同步項。
|
2026-08-31 13:37:33 +08:00 |
|
|
jiantw83
|
651dc19be9
|
docs(guidelines): 改寫相依版本準則並補上技能行為清單合約
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：涵蓋這次兩件需求的準則與說明文件，一件是相依版本不符改為阻擋執行，一件是技能行為清單。
|
2026-08-31 13:37:22 +08:00 |
|
|
jiantw83
|
2e237b7674
|
feat(behaviors): 新增技能行為清單與檢查腳本
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：屬於「技能行為清單」這件需求，提供技能驗證的參考基準。
|
2026-08-31 13:37:04 +08:00 |
|