釋出 jsc-hooks 0.3.6：頁面編號偵測補齊型別 #63

2026-09-01T04:41:15Z

jiantw83 commented

2026-09-01 04:41:15 +00:00

摘要

需求描述：把 MONITOR wiki 頁型別的改動從功能主幹放行到 develop。這是跨 gitea、meta、hooks、assist 四個存放庫的同一批變更，本支是其中一個存放庫的部分。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

各存放庫負責的那一段：

存放庫	這一批改了什麼
`gitea`	型別進 `resolve_wiki_repo()` 白名單與 `check-wiki-rules.sh` 的 `TYPES`，README 兩處型別列舉與環境變數表，`wiki` 技能的 allowed types 與 description，行為清單的呼叫端
`meta`	命名總表新增 `MONITOR` 一列，補雜湊來源與寫入語意說明，並修掉「`CHECK` 是唯一例外」這句不再成立的敘述
`hooks`	`comment-scope.sh` 的 wiki 頁面編號偵測樣式補上 `SKILLSET`、`TOOLING`、`MONITOR`
`assist`	監控頁的目錄頁與內容頁兩份範本

設計重點

這一級才會讓改動真的生效。 marketplace 與 version-guard.sh 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。develop 之後還要再進 master 才算走完階梯。
雜湊來源比照 CHECK，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。刻意不帶工具名稱，這一點與 TOOLING 相反——TOOLING 一支 CLI 一頁，助理則是整台機器一份心跳、一本待辦簿。
監控頁一律附加、不覆寫，與 TOOLING 內容頁「每次盤點覆寫整頁」相反。
hooks 那一段補的兩種型別是既有落差。 SKILLSET 與 TOOLING 長期不在偵測樣式裡，那兩種的頁面編號寫進程式碼註解一直攔不到，這次一併補齊。

測試結果

gitea.sh wiki-repo MONITOR：印出 knowledges/MONITOR，exit 0。改之前回 unknown wiki type: MONITOR、exit 2。
跨型別代用的防護仍在：拿沒設定的型別去試照樣 exit 3，沒有因為新增型別而鬆掉。
check-wiki-rules.sh：exit 0，MONITOR 的三項檢查都涵蓋到。
comment-scope.sh 的偵測樣式實測三種型別各自都攔得下來，命中說明都正好是「jsc wiki 頁面編號」，不是旁邊那條前綴加流水號的樣式誤撿。
四個存放庫各自的 lint-scripts.sh、lint-frontmatter.sh、check-behaviors.sh、ste100-lint.sh 都 exit 0（assist 的 lint-scripts.sh 是 exit 3，因為它確實沒有 tools/ 也沒有 hooks/）。
各 CLI 的最小提示驗證尚未執行。 這一批走的是工作樹路線，改動要等併進預設分支並重新部署之後才驗得了。knowledges/MONITOR 的 wiki 目前還是空的，第一次 wiki-put 才會生出來。

前置 Push Request

無

## 摘要 - 需求描述：把 `MONITOR` wiki 頁型別的改動從功能主幹放行到 `develop`。這是跨 `gitea`、`meta`、`hooks`、`assist` 四個存放庫的同一批變更，本支是其中一個存放庫的部分。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容各存放庫負責的那一段： | 存放庫 | 這一批改了什麼 | | --- | --- | | `gitea` | 型別進 `resolve_wiki_repo()` 白名單與 `check-wiki-rules.sh` 的 `TYPES`，README 兩處型別列舉與環境變數表，`wiki` 技能的 allowed types 與 description，行為清單的呼叫端 | | `meta` | 命名總表新增 `MONITOR` 一列，補雜湊來源與寫入語意說明，並修掉「`CHECK` 是唯一例外」這句不再成立的敘述 | | `hooks` | `comment-scope.sh` 的 wiki 頁面編號偵測樣式補上 `SKILLSET`、`TOOLING`、`MONITOR` | | `assist` | 監控頁的目錄頁與內容頁兩份範本 | ## 設計重點 - **這一級才會讓改動真的生效。** marketplace 與 `version-guard.sh` 都讀存放庫的預設分支，停在功能主幹的內容任何 CLI 都看不到。`develop` 之後還要再進 `master` 才算走完階梯。 - **雜湊來源比照 `CHECK`**，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。刻意不帶工具名稱，這一點與 `TOOLING` 相反——`TOOLING` 一支 CLI 一頁，助理則是整台機器一份心跳、一本待辦簿。 - **監控頁一律附加、不覆寫**，與 `TOOLING` 內容頁「每次盤點覆寫整頁」相反。 - **`hooks` 那一段補的兩種型別是既有落差。** `SKILLSET` 與 `TOOLING` 長期不在偵測樣式裡，那兩種的頁面編號寫進程式碼註解一直攔不到，這次一併補齊。 ## 測試結果 - `gitea.sh wiki-repo MONITOR`：印出 `knowledges/MONITOR`，exit 0。改之前回 `unknown wiki type: MONITOR`、exit 2。 - 跨型別代用的防護仍在：拿沒設定的型別去試照樣 exit 3，沒有因為新增型別而鬆掉。 - `check-wiki-rules.sh`：exit 0，`MONITOR` 的三項檢查都涵蓋到。 - `comment-scope.sh` 的偵測樣式**實測三種型別各自都攔得下來**，命中說明都正好是「jsc wiki 頁面編號」，不是旁邊那條前綴加流水號的樣式誤撿。 - 四個存放庫各自的 `lint-scripts.sh`、`lint-frontmatter.sh`、`check-behaviors.sh`、`ste100-lint.sh` 都 exit 0（`assist` 的 `lint-scripts.sh` 是 exit 3，因為它確實沒有 `tools/` 也沒有 `hooks/`）。 - **各 CLI 的最小提示驗證尚未執行。** 這一批走的是工作樹路線，改動要等併進預設分支並重新部署之後才驗得了。`knowledges/MONITOR` 的 wiki 目前還是空的，第一次 `wiki-put` 才會生出來。 ## 前置 Push Request - 無

jiantw83 added 2 commits 2026-09-01 04:41:16 +00:00

fix(comment-scope): 頁面編號偵測補齊三種缺漏的型別 113df37808

What：
- wiki 頁面編號的偵測樣式補上 SKILLSET、TOOLING 與 MONITOR 三種型別。
- 三份 manifest 的版本一起提升。

Why：
- 這支 hook 的職責是擋住把文件追蹤資訊寫進程式碼註解，wiki 頁面編號正是禁止項之一。
- 樣式只列到 REPORT，但實際的頁型清單早就有 SKILLSET 與 TOOLING，現在再加 MONITOR。清單漏掉的那幾種，頁面編號寫進註解就攔不到，等於這條規則對它們不存在。
- SKILLSET 與 TOOLING 的缺漏是既有落差，不是這次新增型別才產生的，一併補齊比較省事，也不會留下第二個要記得的地方。

How：
- 型別的排列順序照 gitea.sh 的 resolve_wiki_repo 走，兩邊一致才看得出有沒有漏。
- 規則正文的唯一來源仍是 jsc-review 的註解範圍文件，這裡只補偵測樣式，不重述規則清單。
- 實測過三種型別各自都攔得下來，命中的說明都是「jsc wiki 頁面編號」，不是旁邊那條前綴加流水號的樣式誤撿。

Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。

Merge pull request 'feat/monitor-wiki-page-type/page-id-regex' (#62 ) from feat/monitor-wiki-page-type/page-id-regex into feat/monitor-wiki-page-type/main 3cf8d82ffd

Reviewed-on: #62

admin merged commit ea50b7d915 into develop

2026-09-01 04:42:59 +00:00

admin deleted branch feat/monitor-wiki-page-type/main

2026-09-01 04:42:59 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/hooks#63