釋出 jsc-review 0.1.1：新增三支技能的行為清單 #23

2026-08-31T08:14:11Z

jiantw83 commented

2026-08-31 08:14:11 +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，3 節對上 3 支技能，五個欄位齊全。
jsc-meta/tools/ste100-lint.sh：退出 0。
jsc-meta/tools/sync-skill-manifest.sh：退出 0，README 與三份 manifest 同步到 0.1.1。
合併進 develop 後回讀確認：版本 0.1.1、行為清單 3 節。
未跑「開新 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，3 節對上 3 支技能，五個欄位齊全。 - `jsc-meta/tools/ste100-lint.sh`：退出 0。 - `jsc-meta/tools/sync-skill-manifest.sh`：退出 0，README 與三份 manifest 同步到 0.1.1。 - 合併進 develop 後回讀確認：版本 0.1.1、行為清單 3 節。 - 未跑「開新 CLI 行程送最小 Prompt」：這條 PR 合併前，CLI 載入的仍是舊的已安裝副本，跑了驗不到本次變更。 ## 前置 Push Request - 無

jiantw83 added 4 commits 2026-08-31 08:14:11 +00:00

docs(review): 新增三支技能的行為清單 d4fea890c7

What：
在既有的 `references/` 目錄新增 `behaviors.md`。
文件分 api-doc、code-review、comment-cleanup 三節。
每節一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。

Why：
技能驗證缺一份共同的比對基準。
以前只能重讀技能本文推敲行為，判斷因人而異。
清單放在本 repo，技能改動與清單就落在同一個 PR，不會漂移。
也不用為了一次改動跨 repo 開兩條 PR 互卡。

How：
逐支技能盤點行為，再把結果填進五列表。
稽核時修正 comment-cleanup 的外部呼叫敘述。
原本寫成 write-guard.sh 條件式涵蓋這支技能。
實際上那支腳本一律豁免它，而且這支技能根本不呼叫它，已據實改寫。
格式交由 `meta/tools/check-behaviors.sh` 在程式層檢查。

Who：
jsc-review 技能的維護者。
執行技能驗證的人。
日後異動這三支技能的人，都要同步更新這一頁。

chore(manifest): 三份 manifest 升版到 0.1.1 469f4d3445

What：
把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 的版本從 0.1.0 改成 0.1.1。
三份檔案只動 version 一個欄位，其餘內容不變。

Why：
本次新增行為清單，屬於外顯內容的變動。
各 CLI 靠 manifest 版本判斷要不要更新外掛。
版本沒升，安裝端就拿不到新內容。

How：
三份 manifest 一起改成同一個版號。
用 grep 比對三份檔案的 version 欄位，確認完全一致。

Who：
安裝或更新 jsc-review 外掛的每一台機器。
執行 version-guard 版本檢查的流程。

Merge pull request '建立 api-doc、code-review、comment-cleanup 三支技能的行為清單' (#21 ) from feat/skill-behaviors-and-version-block/behavior-list into feat/skill-behaviors-and-version-block/main 46cb8fc053

Merge pull request '收攏 review 三支技能的行為清單，功能主幹併回 develop' (#22 ) from feat/skill-behaviors-and-version-block/main into develop 2e4ce92626

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

admin merged commit dc4495ce8e into master

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

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/review#23