建立 api-doc、code-review、comment-cleanup 三支技能的行為清單 #21

2026-08-31T05:46:42Z

jiantw83 commented

2026-08-31 05:46:42 +00:00

摘要

需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動都要同步更新這份清單。格式由 /root/plugins/meta/tools/check-behaviors.sh 在程式層檢查。清單放在各自的 repo 而不是集中在 meta，理由是技能改動與清單落在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。本 PR 交付 jsc-review 這一個 repo 的清單，並把三份 manifest 升版。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/behaviors.md`	新增檔案，放進既有的 `references/` 目錄。記錄 api-doc、code-review、comment-cleanup 三支技能的行為基準，每節一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。
`.claude-plugin/plugin.json`	版本從 0.1.0 升到 0.1.1，讓 Claude CLI 端抓得到新內容。
`.codex-plugin/plugin.json`	版本從 0.1.0 升到 0.1.1，與另外兩份 manifest 保持同步。
`plugin.json`	版本從 0.1.0 升到 0.1.1，與另外兩份 manifest 保持同步。

設計重點

清單放在 jsc-review 這個 repo，不集中到 meta。技能改動與清單在同一個 PR 一起審，清單不會漂移，也不必跨 repo 開兩條 PR 互卡。
五列表的欄位固定，check-behaviors.sh 才能在程式層檢查格式，不靠人工目測。
稽核時修正一處事實錯誤：comment-cleanup 的外部呼叫原本寫成「write-guard.sh 條件式涵蓋這支技能」。實際上那支腳本的檔頭寫明一律放行 comment-cleanup，而且這支技能根本不呼叫它。已改寫成一律豁免，並補上豁免理由與替代把關方式。
「可驗證跡象」一欄只寫檢查得到的狀態，例如快照檔 ${TMPDIR:-/tmp}/jsc-code-review.$$.diff 是否殘留、$JSC_HOME/sessions/{sid}.lastskill 是否被清掉。驗證者可以直接照著查，不用讀技能本文。
三份 manifest 一起升版，避免不同 CLI 端拿到不同版號。

測試結果

sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/review — 退出碼 0，輸出「行為清單檢查通過：/root/plugins/review/references/behaviors.md 對上 3 支技能，五個欄位齊全」。
grep -h '"version"' .claude-plugin/plugin.json .codex-plugin/plugin.json plugin.json — 退出碼 0，三份都輸出 "version": "0.1.1",，版號一致。
未跑技能實際執行測試。本次只新增文件與調整版號，沒有動任何技能本文或腳本。

前置 Push Request

無

## 摘要 - 需求描述：盤點所有技能組，整理出每支技能的行為清單，作為技能驗證的參考基準。日後任何技能異動都要同步更新這份清單。格式由 `/root/plugins/meta/tools/check-behaviors.sh` 在程式層檢查。清單放在各自的 repo 而不是集中在 meta，理由是技能改動與清單落在同一個 PR 才不會漂移，也不用跨 repo 開兩條 PR 互卡。本 PR 交付 jsc-review 這一個 repo 的清單，並把三份 manifest 升版。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/behaviors.md` | 新增檔案，放進既有的 `references/` 目錄。記錄 api-doc、code-review、comment-cleanup 三支技能的行為基準，每節一張五列表：觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。 | | `.claude-plugin/plugin.json` | 版本從 0.1.0 升到 0.1.1，讓 Claude CLI 端抓得到新內容。 | | `.codex-plugin/plugin.json` | 版本從 0.1.0 升到 0.1.1，與另外兩份 manifest 保持同步。 | | `plugin.json` | 版本從 0.1.0 升到 0.1.1，與另外兩份 manifest 保持同步。 | ## 設計重點 - 清單放在 jsc-review 這個 repo，不集中到 meta。技能改動與清單在同一個 PR 一起審，清單不會漂移，也不必跨 repo 開兩條 PR 互卡。 - 五列表的欄位固定，`check-behaviors.sh` 才能在程式層檢查格式，不靠人工目測。 - 稽核時修正一處事實錯誤：comment-cleanup 的外部呼叫原本寫成「write-guard.sh 條件式涵蓋這支技能」。實際上那支腳本的檔頭寫明一律放行 comment-cleanup，而且這支技能根本不呼叫它。已改寫成一律豁免，並補上豁免理由與替代把關方式。 - 「可驗證跡象」一欄只寫檢查得到的狀態，例如快照檔 `${TMPDIR:-/tmp}/jsc-code-review.$$.diff` 是否殘留、`$JSC_HOME/sessions/{sid}.lastskill` 是否被清掉。驗證者可以直接照著查，不用讀技能本文。 - 三份 manifest 一起升版，避免不同 CLI 端拿到不同版號。 ## 測試結果 - `sh /root/plugins/meta/tools/check-behaviors.sh /root/plugins/review` — 退出碼 0，輸出「行為清單檢查通過：/root/plugins/review/references/behaviors.md 對上 3 支技能，五個欄位齊全」。 - `grep -h '"version"' .claude-plugin/plugin.json .codex-plugin/plugin.json plugin.json` — 退出碼 0，三份都輸出 `"version": "0.1.1",`，版號一致。 - 未跑技能實際執行測試。本次只新增文件與調整版號，沒有動任何技能本文或腳本。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-08-31 05:46:42 +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 版本檢查的流程。

jiantw83 changed title from ~~feat/skill-behaviors-and-version-block/behavior-list~~ to 建立 api-doc、code-review、comment-cleanup 三支技能的行為清單

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

jiantw83 referenced this pull request

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

收攏 review 三支技能的行為清單，功能主幹併回 develop #22

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

#22 收攏 review 三支技能的行為清單，功能主幹併回 develop

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

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

Sign in to join this conversation.