plugins/review
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

release: v0.0.5 develop 到 master #9

Merged
admin merged 8 commits from develop into master 2026-08-27 02:08:13 +00:00
Conversation 1 Commits 8 Files Changed 9
+118 -16
jiantw83 commented 2026-08-27 02:04:15 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 develop 的註解界線規則正文與稽核修正發佈到 master。本存取庫是「程式碼註解禁止夾帶文件相關資訊」這條規則的單一真實來源，其餘網域只放一行指引指過來。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
references/comment-scope.md 新檔，規則正文。適用範圍、30 項禁止清單、7 項白名單、命中時的改法
references/smells.md 第 2 組新增 2.5 文件編號夾帶；嚴重度分級「低」列補上本項
skills/code-review/SKILL.md 第 2 組審查範圍納入 2.5；Notes 寫明與 comment-scope.sh 的分工
README.md 同步技能說明與參考檔表格
稽核修正與文件同步 前一輪 skill-check 的缺失修正
三份 manifest 與 marketplace 正本 同步升版到 0.0.5

設計重點

  • 註解寫「為什麼這樣寫」，不寫「這件事記在哪份文件」。編號會過期、會搬家、會落在存取權限外，讀程式碼的人查不到，最後只剩一串無意義的代號。
  • 白名單留給解釋程式碼本身的編號：日期與時間戳、需求變更歷程、RFC 與 ISO 標準、CVE、第三方套件 issue 連結、授權標頭與 SPDX、@deprecated 等語言原生標記。
  • 與既有兩組壞味道分工明確：2.4 刪解釋性廢話，第 5 組補介面契約，2.5 刪文件編號。
  • 樣式判定不了的兩項留給人工：專案代號、客戶名稱由本技能第 2 組判讀，hook 抓不到。

測試結果

本次發佈前對 develop 樹重跑一輪，實測數據：

  • sh -n 語法檢查所有 shell 腳本：0 錯
  • 所有 JSON 檔通過解析：0 錯
  • jsc-meta 的 ste100-lint.sh 掃整個存取庫：0 命中
  • jsc-hooks 的 lang-guard.sh 逐檔掃描（簡體字、亂碼、非 UTF-8）：0 命中

前置 Push Request

  • 無
## 摘要 - 需求描述：把 develop 的註解界線規則正文與稽核修正發佈到 master。本存取庫是「程式碼註解禁止夾帶文件相關資訊」這條規則的單一真實來源，其餘網域只放一行指引指過來。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/comment-scope.md` | 新檔，規則正文。適用範圍、30 項禁止清單、7 項白名單、命中時的改法 | | `references/smells.md` | 第 2 組新增 `2.5 文件編號夾帶`；嚴重度分級「低」列補上本項 | | `skills/code-review/SKILL.md` | 第 2 組審查範圍納入 2.5；Notes 寫明與 `comment-scope.sh` 的分工 | | `README.md` | 同步技能說明與參考檔表格 | | 稽核修正與文件同步 | 前一輪 skill-check 的缺失修正 | | 三份 manifest 與 marketplace 正本 | 同步升版到 0.0.5 | ## 設計重點 - **註解寫「為什麼這樣寫」，不寫「這件事記在哪份文件」**。編號會過期、會搬家、會落在存取權限外，讀程式碼的人查不到，最後只剩一串無意義的代號。 - **白名單留給解釋程式碼本身的編號**：日期與時間戳、需求變更歷程、RFC 與 ISO 標準、CVE、第三方套件 issue 連結、授權標頭與 SPDX、`@deprecated` 等語言原生標記。 - **與既有兩組壞味道分工明確**：2.4 刪解釋性廢話，第 5 組補介面契約，2.5 刪文件編號。 - **樣式判定不了的兩項留給人工**：專案代號、客戶名稱由本技能第 2 組判讀，hook 抓不到。 ## 測試結果 本次發佈前對 develop 樹重跑一輪，實測數據： - `sh -n` 語法檢查所有 shell 腳本：0 錯 - 所有 JSON 檔通過解析：0 錯 - `jsc-meta` 的 `ste100-lint.sh` 掃整個存取庫：0 命中 - `jsc-hooks` 的 `lang-guard.sh` 逐檔掃描（簡體字、亂碼、非 UTF-8）：0 命中 ## 前置 Push Request - 無
jiantw83 added 8 commits 2026-08-27 02:04:15 +00:00
fix(review): 補齊稽核缺失並修掉護欄失效 9313dea6ee 
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>
docs(review): 同步文件與參考資料 d9d0f6936f 
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>
chore(review): 三份 manifest 同步升版並同步 marketplace 正本 150f0cc07c 
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>
Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#7) from fix/skillset-audit-compliance-and-guard-fixes into develop 1990476b25 
Reviewed-on: #7
feat(review): 新增程式碼註解禁止夾帶文件資訊的規則正文 fd70ce3bc2 
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 組可讀性審查。
feat(review): 技能與說明文件納入文件編號夾帶審查 df81eec8fb 
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 技能與存取庫說明文件。
feat(review): 三份 manifest 同步升版至 0.0.5 0df99db512 
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 外掛的安裝與更新流程。
Merge pull request 'feat/comment-scope-rule' (#8) from feat/comment-scope-rule into develop 8b8f23a17b 
Reviewed-on: #8
admin approved these changes 2026-08-27 02:08:09 +00:00
admin merged commit 4fcf729f39 into master 2026-08-27 02:08:13 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/review#9