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

2026-08-31T06:37:15Z

jiantw83 commented

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

摘要

需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 feat/skill-behaviors-and-version-block/main，再由本 PR 一次併回 develop。本輪功能是寫下 pkg-update 的行為基準，新增行為清單。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

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

設計重點

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

測試結果

本 PR 不含自身提交，測試結果以子功能 PR plugins/pkg#15 為準。該 PR 跑過 check-behaviors.sh，結束碼 0，清單對上 1 支技能；三份 manifest 的版本一致核對過。

前置 Push Request

plugins/pkg#15：#15

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

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

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

jiantw83 added 3 commits 2026-08-31 08:09:27 +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

jiantw83 merged commit da31b890ed 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

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

plugins/pkg

Reference: plugins/pkg#16