plugins/review
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
43 Commits 8 Branches 0 Tags
f6cd1f9ef7f7b68102134556c0e6923b648a7aab
Commit Graph
43 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jiantw83 f6cd1f9ef7 feat(api-doc): 範例只掛純量成員，類別型往下遞迴 
- 使用者要求改判準。類別型參數與中間層的類別屬性只留說明，範例責任往下推給屬性，一路走到最內層的純量。
- 一個值只有一個出處。範例掛在父層，屬性一改就過期，讀的人拿到的是沒有屬性定義背書的一份資料。
- 集合看元素型別，不看外殼；字典看值型別。字串集合與字串判出來一樣，位址集合與位址判出來也一樣。
- 壞味道清單原本寫「輸入與輸出參數都必須有範例」，與新判準衝突，兩支技能會對同一段程式碼給出不同標準。一併改成同一套。
- 說明與範例的兩份檢核表併成一個 sub agent，同一批資料模型檔只讀一次。
- 順帶補上偵測腳本結束碼二漏掉的一個原因：環境缺 grep。原本只寫參數與路徑，遇到這個原因換路徑重跑永遠清不掉。
 2026-08-31 11:07:05 +08:00
jiantw83 a0bd488ac8 feat(tools): 新增發現合併與變更註解兩支腳本 
- 合併、去重、排序原本寫在兩支技能的步驟文字裡，各寫一份就會各自演化。改由腳本執行，並定下六欄 TSV 的回報格式。格式不對就擋下並指出是第幾列，不猜、不放行、不自行補欄。
- 另一支腳本列出本次改到的註解行，清理範圍不再靠肉眼判讀。
- 註解樣式與非程式碼副檔名清單沿用註解範圍腳本的同一份，不另立第二套判準。markdown 的標題行開頭就是井字號，判準不一致就會把整份文件當成註解。
 2026-08-31 11:07:05 +08:00
admin 168113e429 Merge pull request 'feat/plugin-dependencies/main' (#17) from feat/plugin-dependencies/main into develop 
Reviewed-on: #17
 2026-08-28 04:05:16 +00:00
admin 554796aa22 Merge pull request 'feat/plugin-dependencies/declare-requires' (#16) from feat/plugin-dependencies/declare-requires into feat/plugin-dependencies/main 
Reviewed-on: #16
 2026-08-28 04:03:17 +00:00
jiantw83 b60e8c952e feat(manifest): 宣告 review 技能相依版本 2026-08-28 11:59:16 +08:00
admin 219259c354 Merge pull request 'feat/change-requests/main' (#14) from feat/change-requests/main into develop 
Reviewed-on: #14
 2026-08-28 01:51:20 +00:00
admin c1d8162066 Merge pull request 'feat/change-requests/comment-cleanup-skill' (#13) from feat/change-requests/comment-cleanup-skill into feat/change-requests/main 
Reviewed-on: #13
 2026-08-28 01:47:03 +00:00
jiantw83 b3d8337001 feat(comment-cleanup): 新增註解清理技能 2026-08-28 09:30:37 +08:00
jiantw83 aaa0227464 feat(comment-scope): 擴充審查流程痕跡規則 2026-08-28 09:30:33 +08:00
admin 5a2d5d1bab Merge pull request 'feat(review): 新增 API 文件稽核技能，第 5 組擴充註解的條列、導向與標示規則' (#11) from feat/api-doc-audit/main into develop 
Reviewed-on: #11
 2026-08-27 08:54:28 +00:00
admin 8eb330a62f Merge pull request 'feat(review): 新增 API 文件稽核技能，第 5 組擴充註解的條列、連結與標示規則' (#10) from feat/api-doc-audit/api-doc-and-comment-rules into feat/api-doc-audit/main 
Reviewed-on: #10
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-27 07:45:15 +00:00
jiantw83 8b5cc602dc chore(manifest): 三份 manifest 同步升版至 0.0.6 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三份
manifest 的 version 由 0.0.5 改為 0.0.6。

Why：這批新增了 api-doc 技能與 swagger-detect.sh，也擴充了第 5 組的審查項目，
屬於功能異動。版本沒跟著升，各 CLI 端的外掛版本護欄就分不出新舊，已安裝的
使用者也收不到更新。

How：三份 manifest 只改 version 欄位，其餘欄位維持原樣，三處版本號保持一致。

Who：jsc-review 外掛的安裝與更新流程。
 2026-08-27 15:41:38 +08:00
jiantw83 51c2705667 feat(review): code-review 範圍改為 5.1 到 5.8 並補上與 api-doc 的分工 
What：skills/code-review/SKILL.md 的審查範圍表，第 5 組由原本一句
「smells.md group 5」改成明確的 5.1 到 5.8，並點名 5.6、5.7、5.8 三個新項目；
Notes 加一行分工，Swagger 文件稽核歸 api-doc。README.md 新增 api-doc 的技能
小節，另補一張工具表格列出 swagger-detect.sh。

Why：sub agent 讀的是 SKILL.md 的審查範圍表，範圍表沒寫清楚，新增的 5.6 到
5.8 就不會被查。使用者讀的是 README.md，新技能與新工具沒列出來就找不到。
兩支技能都碰註解與文件，界線不寫明就會對同一個缺失重複回報。

How：範圍表的第 5 組直接列出三個新項目與各自的判準重點，完整清單仍指向
references/smells.md。Notes 寫明 api-doc 負責狀態碼的回覆類型、Swagger 參數
說明與範例，第 5 組只負責原始碼註解契約。README.md 的技能小節寫明偵測先行、
只裝套件沒掛接就停手；工具表格列出 swagger-detect.sh 的用途、輸出欄位與結束碼。

Who：jsc-review 的 code-review 技能與存取庫說明文件。
 2026-08-27 15:41:38 +08:00
jiantw83 dfaa66feda feat(api-doc): 新增 API 文件稽核技能 
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 收尾時呼叫。
 2026-08-27 15:41:38 +08:00
jiantw83 57ac9cdcd9 feat(swagger-detect): 新增判斷專案有沒有啟用 Swagger 的工具 
What：新增 tools/swagger-detect.sh，判斷一個專案有沒有真的啟用 Swagger 文件。
涵蓋 dotnet、nodejs、python 三種技術棧，輸出 support=、stack=、package=、
config= 四類欄位；結束碼 0 支援、1 不支援、2 參數個數不對或專案路徑不存在。

Why：API 文件稽核只對產得出 Swagger 文件的專案有意義。支不支援如果交給 agent
自己看程式碼判斷，同一個專案可能這次說支援、下次說不支援。判定寫成腳本，呼叫端
讀結束碼分支就好，不必自己猜。

How：雙重確認，套件與設定缺一不算支援。第一關在套件宣告檔裡找已知的 Swagger
套件，第二關在原始碼裡找真的把 Swagger 接上去的呼叫或裝飾子。設定關鍵字一律
挑接線動作，不挑 import 或 require——光是引入套件不代表文件真的掛上去了。裝了
套件卻沒啟用的專案很常見，只看套件會誤判，讓稽核跑在一個根本產不出文件的專案
上。輸出刻意做成一行一個 key=value，呼叫端逐行讀就好。

Who：jsc-review 的 api-doc 技能，以及 jsc-sdlc 實作階段的收尾稽核。
 2026-08-27 15:41:38 +08:00
jiantw83 dbaf81005b feat(smells): 第 5 組擴充條列式步驟、導向連結與標示語法 
What：references/smells.md 第 5 組擴充。5.1 的方法描述後面要接條列式的處理步驟
與規則，5.3 的回傳值是自訂資料模型時要附上型別定義的導向連結；新增 5.6 內含
功能的導向連結、5.7 XML 註解標籤各占一行、5.8 註解裡的專有名詞與變數依語言
慣例標示。文末的嚴重度分級補上一張表，逐項標明這五個新項目的級別與理由。

Why：使用者提出的產出物文件品質規則裡，有三條講的都是原始碼註解要寫到什麼
程度。動手前先比對過既有內容，第 5 組已經涵蓋大部分，缺的是條列步驟、導向
連結與標示語法這三塊。另開一支技能會跟 code-review 的目標重疊，所以直接擴充
第 5 組。新項目多半屬於可讀性層級，混在原本「註解缺漏」一句話裡分不出輕重，
所以級別另外列。

How：5.1 與 5.3 在原有定義後面接上新要求，偵測訊號與建議重構手法同步補列，
原本的判準一個都不動。5.6 到 5.8 照既有小節的四段結構寫：定義、偵測訊號、
建議重構手法、注意事項。5.8 的標示語法用表格對照 XML 與 JSDoc、docstring
兩類格式。5.6 與 5.7 都寫明註解格式不支援時不適用，避免硬造連結字串，也避免
把 XML 的排版規則套到沒有結束標籤的格式上。

Who：jsc-review 的壞味道參考清單，第 5 組註解契約。
 2026-08-27 15:41:38 +08:00
admin 8b8f23a17b Merge pull request 'feat/comment-scope-rule' (#8) from feat/comment-scope-rule into develop 
Reviewed-on: #8
 2026-08-27 00:56:41 +00:00
jiantw83 0df99db512 feat(review): 三份 manifest 同步升版至 0.0.5 
What：plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json
三份 manifest 的 version 由 0.0.4 改為 0.0.5。

Why：本次新增了註解內容界線規則，屬於功能異動。版本沒跟著升，各 CLI 端的
外掛版本護欄就分不出新舊，已安裝的使用者也收不到更新。

How：三份 manifest 只改 version 欄位，其餘欄位維持原樣，三處版本號保持一致。

Who：jsc-review 外掛的安裝與更新流程。
 2026-08-26 19:00:38 +08:00
jiantw83 df81eec8fb feat(review): 技能與說明文件納入文件編號夾帶審查 
What：skills/code-review/SKILL.md 的第 2 組 Obscurity 審查範圍納入 2.5，
Notes 補上與 jsc-hooks 的 comment-scope.sh 分工說明；README.md 的技能說明
與參考檔表格同步。

Why：規則正文放進 references 還不夠，sub agent 讀的是 SKILL.md 的審查範圍表。
範圍表沒寫，第 2 組就不會查這一項。使用者讀的是 README.md，參考檔沒列出來就找不到。

How：審查範圍表的第 2 組直接列出六類命中樣式，並指向 references/comment-scope.md
取完整清單。Notes 寫明 comment-scope.sh 負責樣式判定得了的項目，第 2 組負責
樣式判定不了的專案代號與客戶名稱，兩邊不重複回報。README.md 表格新增一列。

Who：jsc-review 的 code-review 技能與存取庫說明文件。
 2026-08-26 19:00:38 +08:00
jiantw83 fd70ce3bc2 feat(review): 新增程式碼註解禁止夾帶文件資訊的規則正文 
What：新增 references/comment-scope.md 規則正文，並在 references/smells.md
第 2 組加入 2.5 文件編號夾帶，嚴重度分級「低」列補上本項。

Why：註解寫「這件事記在哪份文件」，讀程式碼的人查不到。編號會過期、會搬家、
會落在存取權限外，最後只剩一串無意義的代號。註解該寫的是「為什麼這樣寫」。

How：規則正文限定適用範圍只到程式碼註解，docstring、README、commit 訊息不受限。
禁止清單三十項分四組：追蹤系統編號、jsc wiki 頁面編號、需求與規格編號、
流程與人事資訊。白名單七項：日期與時間戳、需求變更歷程、RFC 與 ISO 標準、CVE、
第三方套件 issue 連結、授權標頭與 SPDX、語言原生標記。

Who：jsc-review 的 code-review 技能，第 2 組可讀性審查。
 2026-08-26 19:00:38 +08:00
admin 1990476b25 Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#7) from fix/skillset-audit-compliance-and-guard-fixes into develop 
Reviewed-on: #7
 2026-08-25 07:15:21 +00:00
jiantw83andClaude Opus 5 150f0cc07c chore(review): 三份 manifest 同步升版並同步 marketplace 正本 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 d9d0f6936f docs(review): 同步文件與參考資料 
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 9313dea6ee fix(review): 補齊稽核缺失並修掉護欄失效 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
admin f0f6d049ca Merge pull request '發佈 jsc-review 0.0.2：marketplace 正本移至 plugins/meta' (#6) from develop into master 
Reviewed-on: #6
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 10:19:47 +00:00
admin 51210bc42d Merge pull request 'chore(marketplace 正本): 正本移至 plugins/meta（升版 0.0.2）' (#5) from chore/marketplace-canon-to-meta into develop 
Reviewed-on: #5
 2026-08-24 10:14:11 +00:00
jiantw83andClaude Opus 5 a78b990344 chore(plugin 版本): 三份 manifest 升版至 0.0.2 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 ba2d61667f docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
admin 70fde94290 Merge pull request '發佈 jsc-review：marketplace 同步（尚未升版，見 PR 說明）' (#4) from develop into master 
Reviewed-on: #4
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 08:28:15 +00:00
admin 595270eaac Merge pull request 'fix/sync-marketplace-registry' (#3) from fix/sync-marketplace-registry into develop 
Reviewed-on: #3
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 07:58:20 +00:00
jiantw83 6f3d99182c fix(marketplace): 同步 marketplace.json 至 canonical 版本 
What: 更新 .claude-plugin/marketplace.json 與 .agents/plugins/marketplace.json 兩份 marketplace 登錄檔，補齊缺漏或不一致的 description 與 owner 欄位。
Why: 兩份登錄檔與 canonical 的 plugins/jsc marketplace.json 不一致，.agents/plugins 版本缺少多個外掛的 description 與 owner 欄位，.claude-plugin 版本有一處用字不一致（「新建/更新/刪除」應為「新建、更新、刪除」）。
How: 直接以修正後的 canonical plugins/jsc marketplace.json 內容覆蓋這兩份登錄檔，使三份檔案完全一致。
Who: jsc-meta:skill-check 例行合規稽核 — jsc-review 網域自身技能（code-review）已零缺失通過稽核，僅剩共用 marketplace 登錄檔需要同步。
 2026-08-24 14:47:59 +08:00
admin 2aad771dad Merge pull request 'feat(review): 匯入 jsc-review 技能組並統一 marketplace 為 jsc' (#2) from develop into master 
Reviewed-on: #2
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 06:41:16 +00:00
jiantw83andClaude Fable 5 0a5ad4f75f chore(review): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:50 +08:00
jiantw83andClaude Fable 5 3692c9e915 style(review): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:47 +08:00
jiantw83andClaude Fable 5 ccf83badbb docs(review): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:47 +08:00
jiantw83andClaude Fable 5 2c03779e41 style(review): 依 STE100 擬人台灣感規則改寫語感 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:17:32 +08:00
jiantw83andClaude Fable 5 5896f09f68 docs(review): AGENTS 語言規則改指向 jsc-meta 的 references/ste100.md 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:13:27 +08:00
jiantw83andClaude Fable 5 914e17eed8 docs(review): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:39 +08:00
jiantw83andClaude Fable 5 19da66d0ba chore(review): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:39 +08:00
jiantw83andClaude Fable 5 c318917b1e docs(review): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 e1cc4ed6c4 feat(review): 匯入 jsc-review 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 83e7a1113e chore(review): 修正範本 manifest 與移除 hello 範例符合 review 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00
jiantw83 a87d314ba8 Initial commit 2026-08-21 04:43:03 +00:00