jiantw83
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 組可讀性審查。