3 Commits
Author SHA1 Message Date
admin 9c51958d24 Merge pull request '補上規則正文的十六進位色碼允許項,與守門腳本白名單對齊' (#33) from docs/comment-scope/main into develop
Reviewed-on: #33
2026-09-08 07:08:26 +00:00
jiantw83andClaude Opus 5 da361a18e6 chore(version): 三份 manifest 升版至 0.1.4
註解規範正文多了一列允許項,行為跟著變,版號要動。三份 manifest 的版號
必須一致,版本前置檢查是拿它們互相比對的。

由 0.1.3 升到 0.1.4,末位加一。改動只在版號那一行,描述、技能路徑與其他
欄位一個字都沒碰。

影響部署與版本前置檢查:升上去之後,各 CLI 端才抓得到帶新規則的這一版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-08 15:04:21 +08:00
jiantw83andClaude Opus 5 87e4555a90 docs(comment-scope): 色碼列進允許項,不再當編號看
「允許寫進註解」那張表加一列:十六進位色碼。理由寫在同一列——它指的是顏
色,不是編號;只有純十進位的才當議題編號看。

守門腳本那一邊已經多剪一條,把井號後面含十六進位字母的色碼先剪掉。正文
是規則的唯一真實來源,腳本剪了一條而正文不動,下一個讀正文的人會以為色
碼仍然違規,於是把註解裡的色碼手動刪掉,或反過來覺得腳本放水。兩邊對不
起來,規則就沒有人信。

補的是一列,不是一段。既有六列的欄位次序照舊,允許項、理由、範例三格都
填滿,範例挑樣式表註解裡標主色那種常見寫法,讀的人一眼看得出這條規則在
講哪種場景。

影響註解範圍的判準本身,也就是所有讀這份正文的人與所有引用它的技能:註
解裡寫色碼從此明文放行,議題編號、需求編號那些照舊禁止。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-08 15:04:21 +08:00
4 changed files with 4 additions and 3 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "jsc-review", "name": "jsc-review",
"version": "0.1.3", "version": "0.1.4",
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組", "description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
"skills": "./skills", "skills": "./skills",
"author": { "author": {
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "jsc-review", "name": "jsc-review",
"version": "0.1.3", "version": "0.1.4",
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組", "description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
"skills": "./skills", "skills": "./skills",
"jsc": { "jsc": {
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "jsc-review", "name": "jsc-review",
"version": "0.1.3", "version": "0.1.4",
"description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組", "description": "程式碼審查:Refactoring 壞味道六組 + 註解規範 + 淺模組",
"skills": "./skills/", "skills": "./skills/",
"jsc": { "jsc": {
+1
View File
@@ -88,6 +88,7 @@
| 第三方套件的 issue 連結 | 說明繞道寫法的成因與解除條件 | `// 繞過 github.com/foo/bar/issues/88,修好後可移除` | | 第三方套件的 issue 連結 | 說明繞道寫法的成因與解除條件 | `// 繞過 github.com/foo/bar/issues/88,修好後可移除` |
| 授權標頭、SPDX 標記 | 法律要求 | `// SPDX-License-Identifier: MIT` | | 授權標頭、SPDX 標記 | 法律要求 | `// SPDX-License-Identifier: MIT` |
| 語言原生標記 | 編譯器或工具鏈直接解讀 | `@deprecated`、`@since` | | 語言原生標記 | 編譯器或工具鏈直接解讀 | `@deprecated`、`@since` |
| 十六進位色碼 | 指的是顏色,不是編號;純十進位的才當議題編號看 | `/* 主色沿用 #7c3aed,別再調 */` |
`@author` 不在允許之列:它是人名,屬「流程與人事資訊」。 `@author` 不在允許之列:它是人名,屬「流程與人事資訊」。