替 ask 這支技能建立行為清單，供技能驗證比對 #17

2026-08-31T05:37:01Z

jiantw83 commented

2026-08-31 05:37:01 +00:00

摘要

需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。每個 repo 新增一份 references/behaviors.md，每支技能一節，一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。格式由 jsc-meta/tools/check-behaviors.sh 在程式層檢查。清單放在各自的 repo，不集中在 meta，技能改動與清單才會落在同一個 PR，不會漂移，也不必跨 repo 開兩條 PR 互卡。ask 這份有 1 節（ask）。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增 jsc-ask 的技能行為清單。收錄 ask 一節，用五列表寫下觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，供技能驗證比對。
`.claude-plugin/plugin.json`	版本由 `0.0.8` 改成 `0.0.9`，標記本次新增行為清單。
`.codex-plugin/plugin.json`	版本由 `0.0.8` 改成 `0.0.9`，與 `.claude-plugin/plugin.json` 保持一致。
`plugin.json`	版本由 `0.0.8` 改成 `0.0.9`，三份 manifest 版本必須同號。

設計重點

清單放在 jsc-ask 自己的 repo。技能檔與行為清單同進同出，改動與描述不會脫節。
每支技能一節，欄位固定五列。jsc-meta/tools/check-behaviors.sh 才能在程式層檢查格式。
「可驗證跡象」寫成外部看得到的結果，例如 wiki 頁面多一節、內容頁時間戳更新。驗證時不必讀技能原始碼。
首行標題與開頭說明點出用途，並要求技能異動時在同一個 PR 內更新這一頁。
三份 manifest 版本一起改。使用者在任何一個 CLI 讀到的版本都相同。

測試結果

本次只新增參考文件與同步版本號，沒有可執行的測試。
jsc-hooks/hooks/comment-scope.sh sweep 在此工作區跑過，退出碼 0。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。每個 repo 新增一份 `references/behaviors.md`，每支技能一節，一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。格式由 `jsc-meta/tools/check-behaviors.sh` 在程式層檢查。清單放在各自的 repo，不集中在 meta，技能改動與清單才會落在同一個 PR，不會漂移，也不必跨 repo 開兩條 PR 互卡。ask 這份有 1 節（ask）。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增 jsc-ask 的技能行為清單。收錄 ask 一節，用五列表寫下觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象，供技能驗證比對。 | | `.claude-plugin/plugin.json` | 版本由 `0.0.8` 改成 `0.0.9`，標記本次新增行為清單。 | | `.codex-plugin/plugin.json` | 版本由 `0.0.8` 改成 `0.0.9`，與 `.claude-plugin/plugin.json` 保持一致。 | | `plugin.json` | 版本由 `0.0.8` 改成 `0.0.9`，三份 manifest 版本必須同號。 | ## 設計重點 - 清單放在 jsc-ask 自己的 repo。技能檔與行為清單同進同出，改動與描述不會脫節。 - 每支技能一節，欄位固定五列。`jsc-meta/tools/check-behaviors.sh` 才能在程式層檢查格式。 - 「可驗證跡象」寫成外部看得到的結果，例如 wiki 頁面多一節、內容頁時間戳更新。驗證時不必讀技能原始碼。 - 首行標題與開頭說明點出用途，並要求技能異動時在同一個 PR 內更新這一頁。 - 三份 manifest 版本一起改。使用者在任何一個 CLI 讀到的版本都相同。 ## 測試結果 - 本次只新增參考文件與同步版本號，沒有可執行的測試。 - `jsc-hooks/hooks/comment-scope.sh sweep` 在此工作區跑過，退出碼 0。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:37:01 +00:00

feat(behaviors): 新增 jsc-ask 技能行為清單 8050cf3a4e

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 技能，以及技能驗證流程。

chore(manifest): 同步三份 manifest 版本至 0.0.9 af2156ccfe

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 的安裝與更新流程。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 替 ask 這支技能建立行為清單，供技能驗證比對

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

jiantw83 referenced this pull request

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

收攏 ask 的技能行為清單，一次併回 develop #18

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

#18 收攏 ask 的技能行為清單，一次併回 develop

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

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

Sign in to join this conversation.