釋出 jsc-ask 0.0.9:新增技能行為清單 #19

Merged
admin merged 4 commits from develop into master 2026-08-31 08:17:56 +00:00
Member

摘要

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

變更內容

檔案 為什麼改
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:05 +00:00
What:新增 `references/behaviors.md`。內含 ask 一節。該節是一張五列表,欄位為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。頁首說明這份清單的用途,並要求技能異動時在同一個 PR 內一起更新。

Why:技能驗證原本沒有共同的比對基準,驗證結果隨人而異。先盤點所有技能組,替每支技能寫下行為基準,驗證時直接比對這份清單。清單放在 jsc-ask 自己的 repo,不集中在 meta。技能改動與清單落在同一個 PR,內容才不會漂移,也不必跨 repo 開兩條 PR 互卡。

How:逐項讀過 ask 技能的現有流程,抽出五個面向填進表格。觸發時機同時寫下不叫用的情況。關鍵步驟依實際執行順序排列。外部呼叫列出腳本、技能、工具與範本。完成條件寫下成功標準與三種停止執行的情況。可驗證跡象寫成外部看得到的結果,例如 wiki 頁面多一節、內容頁時間戳更新,驗證時不必讀技能原始碼。表格格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。

Who:jsc-ask 的 ask 技能,以及技能驗證流程。
What:把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 的 `version` 由 `0.0.8` 改成 `0.0.9`。三份檔案只動這一個欄位。

Why:本次新增技能行為清單,套件內容已經改變。版本號要一起進版,安裝端才收得到更新。三份 manifest 分別供不同 CLI 讀取,版本必須同號,否則使用者在不同 CLI 會讀到不一致的版本。

How:逐份 manifest 只改 `version` 這一個鍵,其餘欄位維持原樣。三份改成同一個版本號 0.0.9。版本進位採修補號,因為本次只新增參考文件,沒有改動技能行為。

Who:jsc-ask 套件的版本標示,以及 jsc-cli:deploy 的安裝與更新流程。
admin approved these changes 2026-08-31 08:17:54 +00:00
admin merged commit 8c50921e91 into master 2026-08-31 08:17:56 +00:00
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/ask#19