釋出 jsc-pkg 0.0.9：新增技能行為清單 #17

2026-08-31T08:14:10Z

jiantw83 commented

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

摘要

需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準，日後技能異動都要同步更新；相依技能版本不符時不得跳過更新，改為阻擋執行。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增。技能行為清單，作為技能驗證的參考基準
三份 manifest	版本同步

設計重點

行為清單放在各 domain 而不是集中在 jsc-meta：技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。
五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，由 jsc-meta/tools/check-behaviors.sh 在程式層檢查。

測試結果

jsc-meta/tools/check-behaviors.sh：退出 0，1 節對上 1 支技能，五個欄位齊全。
jsc-meta/tools/ste100-lint.sh：退出 0。
jsc-meta/tools/sync-skill-manifest.sh：退出 0，README 與三份 manifest 同步到 0.0.9。
合併進 develop 後回讀確認：版本 0.0.9、行為清單 1 節。
未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本，跑了驗不到本次變更。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準，日後技能異動都要同步更新；相依技能版本不符時不得跳過更新，改為阻擋執行。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增。技能行為清單，作為技能驗證的參考基準 | | 三份 manifest | 版本同步 | ## 設計重點 - 行為清單放在各 domain 而不是集中在 jsc-meta：技能改動與清單在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。 - 五個欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。 ## 測試結果 - `jsc-meta/tools/check-behaviors.sh`：退出 0，1 節對上 1 支技能，五個欄位齊全。 - `jsc-meta/tools/ste100-lint.sh`：退出 0。 - `jsc-meta/tools/sync-skill-manifest.sh`：退出 0，README 與三份 manifest 同步到 0.0.9。 - 合併進 develop 後回讀確認：版本 0.0.9、行為清單 1 節。 - 未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本，跑了驗不到本次變更。 ## 前置 Push Request - 無

jiantw83 added 4 commits 2026-08-31 08:14:10 +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 判斷是否需要更新。
- 使用者安裝或更新外掛時，看到的是這個版本。

Merge pull request '寫下 pkg-update 的行為基準，新增行為清單' (#15 ) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main b3d2c5dc6d

Merge pull request '收攏 pkg-update 的行為清單，功能主幹併回 develop' (#16 ) from feat/skill-behaviors-and-version-block/main into develop da31b890ed

admin approved these changes 2026-08-31 08:19:08 +00:00

admin merged commit 67fa5c5f57 into master

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

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/pkg#17