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

2026-08-31T06:37:16Z

jiantw83 commented

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

摘要

需求描述：本 PR 是功能主幹的收攏層。子功能 PR 先併入 feat/skill-behaviors-and-version-block/main，再由本 PR 一次併回 develop。本輪功能是建立 api-doc、code-review、comment-cleanup 三支技能的行為清單。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

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

設計重點

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

測試結果

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

前置 Push Request

plugins/review#21：#21

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

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

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

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

jiantw83 merged commit 2e4ce92626 into develop

2026-08-31 08:10:39 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Depends on

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

plugins/review

Reference: plugins/review#22