jiantw83
dfaa66feda
What：新增 skills/api-doc/SKILL.md。六步流程：偵測 Swagger 支援、不支援就回報 並停手、列出稽核範圍、分三個面向各開一個 sub agent 稽核、彙整去重排序、回報 發現。三個面向分別是狀態碼的回覆類型、參數說明與範例、資料模型遞迴。本技能 只回報「檔案:行號」、嚴重度與建議修法，不改程式碼。 Why：支援 Swagger 的專案要把控制器文件補全：所有可能出現的狀態碼都宣告回覆 類型，輸入輸出都要有說明與真實資料範例，參數是資料模型就每個屬性都套用、內含 模型再往下遞迴。這是 code-review 六組沒碰過的領域，跟第 5 組的原始碼註解契約 也不是同一件事，所以獨立成一支技能，不塞進既有的六組裡。 How：第一步跑 tools/swagger-detect.sh，讀結束碼決定走下去還是停手，不支援時 一個 sub agent 都不開，直接回報未啟用。範例優先取專案的真實資料，資料庫、 種子資料、測試夾具都算；真的取不到才依邏輯推導，並在文件裡標上「推導值」， 讓後面讀的人知道這個值沒被觀察過。取自資料庫的範例一律去識別化，個人資料不 進 Swagger 文件。分工另立一節：本技能只管 Swagger 文件屬性，原始碼註解契約 歸 code-review 第 5 組，同一個缺失不會被回報兩次。 Who：jsc-review 新增的 api-doc 技能，由 jsc-sdlc 的 implement 收尾時呼叫。
jsc-review — 程式碼審查
jsc 技能組的 review domain：基於《Refactoring》壞味道目錄的六組審查（結構與體積、可讀性與命名、耦合與設計、邏輯與壞習慣、註解規範、淺模組），套用在檔案變更完成與實作完成兩個時機。
安裝、更新、移除
Marketplace 統一為 jsc（https://gitea.jsc.idv.tw/plugins/meta.git），安裝 token 為 jsc-review@jsc。每個指令一行：
| CLI | 安裝 | 更新 | 移除 |
|---|---|---|---|
| claude | claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && claude plugin install jsc-review@jsc |
claude plugin marketplace update jsc && claude plugin update jsc-review@jsc |
claude plugin uninstall jsc-review@jsc |
| codex | codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && codex plugin add jsc-review@jsc |
codex plugin marketplace upgrade jsc |
codex plugin remove jsc-review@jsc |
| copilot | copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && copilot plugin install jsc-review@jsc |
copilot plugin marketplace update jsc && copilot plugin update jsc-review@jsc |
copilot plugin uninstall jsc-review@jsc |
| antigravity | git clone https://gitea.jsc.idv.tw/plugins/review.git ~/plugins/review && agy plugin install ~/plugins/review |
git -C ~/plugins/review pull && agy plugin uninstall jsc-review && agy plugin install ~/plugins/review |
agy plugin uninstall jsc-review |
| kiro | kiro-cli plugin marketplace add https://gitea.jsc.idv.tw/plugins/meta.git && kiro-cli plugin install jsc-review@jsc |
kiro-cli plugin marketplace update jsc && kiro-cli plugin update jsc-review@jsc |
kiro-cli plugin uninstall jsc-review@jsc |
antigravity 不支援 gitea URL 安裝，改用本地 clone 路徑。批次操作五個 CLI：使用
/jsc-cli:deploy。
舊入口
plugins/jsc已移除，marketplace 正本移到plugins/meta。marketplace 名稱仍是jsc（取自 marketplace.json 的name欄位，與存取庫名無關），安裝 token 不變；已從舊入口安裝過的人先執行claude plugin marketplace remove jsc，再依上表重新 add。
Skills 目錄
呼叫方式：Claude / Antigravity /jsc-review:{name}；Codex ${name}；Copilot / Kiro 描述需求自動觸發。
code-review
對 git diff 進行六組壞味道審查，每組一個 sub agent 平行執行；回報 檔案:行號、嚴重度、建議重構手法，修正與否由呼叫端決定。第 2 組同時擋「文件編號夾帶」：註解只寫「為什麼這樣寫」，議題編號、wiki 頁編號、工作包編號、commit hash、@ 提及、外部文件連結一律不進註解，清單看 references/comment-scope.md。diff 是空的就直接回報「無發現」，不開任何 sub agent；六組全部回覆才進入彙整，沒東西可報的那組也要回「無發現」。安全性與 bug 審查交給 CLI 內建 review，不重複。
參考
| 檔案 | 用途 |
|---|---|
references/smells.md |
六組壞味道完整清單：定義、偵測訊號、建議重構手法、嚴重度分級；範例資料必須去識別化 |
references/comment-scope.md |
程式碼註解內容界線：禁止寫進註解的文件編號清單、允許項目與白名單、命中時的改法 |
相關 domain
jsc-sdlc：實作階段完成後呼叫本審查