補上規則正文的十六進位色碼允許項，與守門腳本白名單對齊 #33

2026-09-08T07:06:52Z

jiantw83 commented

2026-09-08 07:06:52 +00:00

摘要

需求描述：註解範圍守門的白名單新增了十六進位色碼，規則正文得有對應的一列。正文是規則的唯一真實來源，腳本只是它的執行面，兩邊不能各說各話。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
references/comment-scope.md	「允許寫進註解」表格加一列十六進位色碼，寫明理由是它指顏色而不是編號，純十進位的才當議題編號看。
plugin.json	規則正文變動，版號同步升到 0.1.4。
.claude-plugin/plugin.json	同上，三份 manifest 版號必須一致。
.codex-plugin/plugin.json	同上，三份 manifest 版號必須一致。

設計重點

這份只做正文同步，不動任何腳本。守門邏輯的修改在 jsc-hooks 那一份，兩者一組。
新增那一列的理由欄直接寫清楚判準：看的是有沒有十六進位字母，而不是看井號。這樣讀正文的人不必回頭翻腳本就知道界線在哪。
表格的例子欄沿用其他列的寫法，一句註解帶一個具體場景，讓人照抄就會寫對。
允許清單只長一列，其他列與命中時的改法都不動，避免順手擴大範圍。

測試結果

文件變更，無自動化測試。
改以人工逐條對照確認：把守門腳本白名單裡的每一條剪除規則列出來，與正文「允許寫進註解」表格的每一列一一配對，確認新增的色碼那一列對得上腳本新加的那一條，並確認腳本沒有正文未記載的白名單，正文也沒有腳本未實作的允許項。

前置 Push Request

plugins/hooks#96

## 摘要 - 需求描述：註解範圍守門的白名單新增了十六進位色碼，規則正文得有對應的一列。正文是規則的唯一真實來源，腳本只是它的執行面，兩邊不能各說各話。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | references/comment-scope.md | 「允許寫進註解」表格加一列十六進位色碼，寫明理由是它指顏色而不是編號，純十進位的才當議題編號看。 | | plugin.json | 規則正文變動，版號同步升到 0.1.4。 | | .claude-plugin/plugin.json | 同上，三份 manifest 版號必須一致。 | | .codex-plugin/plugin.json | 同上，三份 manifest 版號必須一致。 | ## 設計重點 - 這份只做正文同步，不動任何腳本。守門邏輯的修改在 jsc-hooks 那一份，兩者一組。 - 新增那一列的理由欄直接寫清楚判準：看的是有沒有十六進位字母，而不是看井號。這樣讀正文的人不必回頭翻腳本就知道界線在哪。 - 表格的例子欄沿用其他列的寫法，一句註解帶一個具體場景，讓人照抄就會寫對。 - 允許清單只長一列，其他列與命中時的改法都不動，避免順手擴大範圍。 ## 測試結果 - 文件變更，無自動化測試。 - 改以人工逐條對照確認：把守門腳本白名單裡的每一條剪除規則列出來，與正文「允許寫進註解」表格的每一列一一配對，確認新增的色碼那一列對得上腳本新加的那一條，並確認腳本沒有正文未記載的白名單，正文也沒有腳本未實作的允許項。 ## 前置 Push Request - https://gitea.jsc.idv.tw/plugins/hooks/pulls/96

jiantw83 added 2 commits 2026-09-08 07:06:53 +00:00

docs(comment-scope): 色碼列進允許項，不再當編號看 87e4555a90

「允許寫進註解」那張表加一列：十六進位色碼。理由寫在同一列——它指的是顏
色，不是編號；只有純十進位的才當議題編號看。

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

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

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

chore(version): 三份 manifest 升版至 0.1.4 da361a18e6

註解規範正文多了一列允許項，行為跟著變，版號要動。三份 manifest 的版號
必須一致，版本前置檢查是拿它們互相比對的。

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

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

jiantw83 added a new dependency 2026-09-08 07:07:00 +00:00

plugins/hooks#96 - 修正註解範圍守門把樣式表色碼誤判為議題編號的問題

admin merged commit 9c51958d24 into develop

2026-09-08 07:08:26 +00:00

admin deleted branch docs/comment-scope/main

2026-09-08 07:08:26 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Depends on

#96 修正註解範圍守門把樣式表色碼誤判為議題編號的問題

plugins/hooks

Reference: plugins/review#33