寫下 pkg-update 的行為基準，新增行為清單 #15

2026-08-31T05:43:45Z

jiantw83 commented

2026-08-31 05:43:45 +00:00

摘要

需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。清單放在各自的 repo，技能異動時在同一個 PR 內同步更新。格式由 /root/plugins/meta/tools/check-behaviors.sh 在程式層檢查。本 PR 交付 jsc-pkg 這個 repo 的清單，並把三份 manifest 升版到 0.0.9。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
references/behaviors.md	新增檔案，記錄 pkg-update 的行為基準，供技能驗證比對。一節一支技能，節內五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。`references/` 目錄同時新建。
.claude-plugin/plugin.json	外顯內容變更要升版，版本由 0.0.8 改成 0.0.9。
.codex-plugin/plugin.json	與 Claude manifest 保持同版本，版本由 0.0.8 改成 0.0.9。
plugin.json	與另外兩份 manifest 保持同版本，版本由 0.0.8 改成 0.0.9。

設計重點

清單放在技能自己的 repo，不集中在 meta。技能改動與清單進同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。
五個欄位固定，格式由 check-behaviors.sh 在程式層檢查，不靠人工目視。
「關鍵步驟」寫到工具腳本層級，例如 tools/git-guard.sh check、tools/apply-version.sh，驗證時才對得上實際行為。
「完成條件」把成功、還原、停手三種結局分開寫，避免只驗成功路線。
「可驗證跡象」只寫外部看得到的證據，例如 git diff 的版本字串變動、鎖定檔與安裝產物、git log 的 commit，並明講這支技能不寫 wiki 頁、不開 PR。
commit 分兩組：行為清單文件走 docs，三份 manifest 升版走 chore。

測試結果

sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/pkg，退出碼 0。輸出：行為清單檢查通過：/root/plugins/pkg/references/behaviors.md 對上 1 支技能，五個欄位齊全。
grep -H '"version"' .claude-plugin/plugin.json .codex-plugin/plugin.json plugin.json，退出碼 0。三份 manifest 都印出 "version": "0.0.9"，版本一致。
沒有跑 pkg-update 本身的實跑測試。這次變更只動文件與版本欄位，沒有改任何技能邏輯或工具腳本。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。清單放在各自的 repo，技能異動時在同一個 PR 內同步更新。格式由 `/root/plugins/meta/tools/check-behaviors.sh` 在程式層檢查。本 PR 交付 jsc-pkg 這個 repo 的清單，並把三份 manifest 升版到 0.0.9。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | references/behaviors.md | 新增檔案，記錄 pkg-update 的行為基準，供技能驗證比對。一節一支技能，節內五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。`references/` 目錄同時新建。 | | .claude-plugin/plugin.json | 外顯內容變更要升版，版本由 0.0.8 改成 0.0.9。 | | .codex-plugin/plugin.json | 與 Claude manifest 保持同版本，版本由 0.0.8 改成 0.0.9。 | | plugin.json | 與另外兩份 manifest 保持同版本，版本由 0.0.8 改成 0.0.9。 | ## 設計重點 - 清單放在技能自己的 repo，不集中在 meta。技能改動與清單進同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。 - 五個欄位固定，格式由 `check-behaviors.sh` 在程式層檢查，不靠人工目視。 - 「關鍵步驟」寫到工具腳本層級，例如 `tools/git-guard.sh check`、`tools/apply-version.sh`，驗證時才對得上實際行為。 - 「完成條件」把成功、還原、停手三種結局分開寫，避免只驗成功路線。 - 「可驗證跡象」只寫外部看得到的證據，例如 `git diff` 的版本字串變動、鎖定檔與安裝產物、`git log` 的 commit，並明講這支技能不寫 wiki 頁、不開 PR。 - commit 分兩組：行為清單文件走 docs，三份 manifest 升版走 chore。 ## 測試結果 - `sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/pkg`，退出碼 0。輸出：`行為清單檢查通過：/root/plugins/pkg/references/behaviors.md 對上 1 支技能，五個欄位齊全`。 - `grep -H '"version"' .claude-plugin/plugin.json .codex-plugin/plugin.json plugin.json`，退出碼 0。三份 manifest 都印出 `"version": "0.0.9"`，版本一致。 - 沒有跑 pkg-update 本身的實跑測試。這次變更只動文件與版本欄位，沒有改任何技能邏輯或工具腳本。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:43:46 +00:00

docs(behaviors): 新增 jsc-pkg 技能行為清單 49fef7069e

What：
- 新建 references/ 目錄。
- 新增 references/behaviors.md，收錄 pkg-update 一支技能。
- 每支技能一節，節內五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。

Why：
- 技能驗證需要一份行為基準來比對。
- 清單放在技能自己的 repo，技能改動與清單就能進同一個 PR。
- 同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。

How：
- 盤點 skills/ 下的技能，逐支寫出五個欄位的內容。
- 關鍵步驟寫到工具腳本層級，外部呼叫列出腳本、技能與外部服務。
- 格式交給 meta/tools/check-behaviors.sh 在程式層檢查。

Who：
- 技能驗證流程讀這份清單當基準。
- 日後任何技能異動，都要在同一個 PR 內同步更新這一頁。

chore(manifest): 三份 manifest 升版到 0.0.9 0dccd19061

What：
- .claude-plugin/plugin.json 版本改成 0.0.9。
- .codex-plugin/plugin.json 版本改成 0.0.9。
- plugin.json 版本改成 0.0.9。

Why：
- 這次新增行為清單，屬於外顯內容變更，要跟著升版。
- 版本守門會比對三份 manifest，版本不一致就報錯。

How：
- 由 0.0.8 遞增到 0.0.9，只改版本欄位。
- 三份檔案改成同一個版本字串。

Who：
- 版本守門讀這三份 manifest 判斷是否需要更新。
- 使用者安裝或更新外掛時，看到的是這個版本。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 寫下 pkg-update 的行為基準，新增行為清單

2026-08-31 06:36:25 +00:00

jiantw83 referenced this pull request

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

收攏 pkg-update 的行為清單，功能主幹併回 develop #16

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

#16 收攏 pkg-update 的行為清單，功能主幹併回 develop

jiantw83 merged commit b3d2c5dc6d into feat/skill-behaviors-and-version-block/main

2026-08-31 08:09:26 +00:00

Sign in to join this conversation.