plugins/review
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
63 Commits 8 Branches 0 Tags
9c51958d2419b9a779d1e939d7d605428e189a58
Commit Graph
8 Commits
Author SHA1 Message Date
jiantw83 d472f81cd2 feat(狀態回報): 收尾寫一筆 skill-end 事件 
現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。
 2026-09-02 16:01:17 +08:00
jiantw83 ced541faa5 fix(review): 補上註解腳本路徑與缺漏的失敗分支 
- 註解範圍腳本的路徑少一層目錄，照著寫會找不到檔案，補上 hooks 那一層。
- 建置測試跑完卻失敗時沒有分支可走，只寫得出「通過」。現在要指出指令、結束碼，並判斷失敗是不是本次改動造成的。
- 取得差異失敗時原本會安靜跳過，現在原樣帶出錯誤並停手。判不出範圍不等於沒有東西要審。
- 禁止清單原本抄了兩份，改成只指向註解範圍的正本，兩份不會各自演化。
- 第二組不再重掃樣式判得出來的項目。hook 關掉或沒接上時就沒有最後一道網，這件事寫進技能文件，不讓它默默消失。
- 差異只算一次，落成一份快照檔給六組共讀；檔名帶執行代號，同一台機器平行跑不會互相覆蓋。註解清理改成一個檔案一個 sub agent 平行跑。
 2026-08-31 11:07:05 +08:00
jiantw83 aaa0227464 feat(comment-scope): 擴充審查流程痕跡規則 2026-08-28 09:30:33 +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 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
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
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 e1cc4ed6c4 feat(review): 匯入 jsc-review 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00