釋出 jsc-meta 0.2.6：命名總表新增 MONITOR #55

2026-09-01T04:41:14Z

jiantw83 commented

2026-09-01 04:41:14 +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:15 +00:00

docs(guidelines): 命名總表加入 MONITOR 頁型別 970b7a4f71

What：
- Wiki 頁命名總表新增 MONITOR 一列，擁有者是技能助理。
- 表下補三段說明：雜湊來源、為什麼不帶工具名稱、寫入語意。
- CHECK 那一段拿掉「是唯一例外」的斷言，改成指向新的機器層規則。
- 三份 manifest 的版本一起提升。

Why：
- 總表是所有 wiki 頁命名的唯一來源。新型別沒登錄進來，各技能就沒有依據，只能各自猜。
- CHECK 原本寫著「是唯一例外」，指的是雜湊來源取主機名與帳號而不是存放庫。加了第二個同樣取法的型別之後，這句話就不成立了，留著會讓讀的人以為只有一個。

How：
- MONITOR 的雜湊來源比照 CHECK，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。
- 刻意不帶工具名稱，這一點與 TOOLING 相反。TOOLING 一支 CLI 一頁，因為每支 CLI 各有自己的已安裝 plugin 與 hook 接線；助理看的是整台機器一份心跳、一本待辦簿，不分 CLI。
- 監控頁一律附加，不覆寫。助理的寫入是背景行為，覆寫錯了沒人在現場。TOOLING 內容頁是每次盤點覆寫整頁，兩者語意相反，所以各自寫明白。
- 只動總表那一節，其餘章節不碰。

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

Merge pull request 'feat/monitor-wiki-page-type/naming-table' (#54 ) from feat/monitor-wiki-page-type/naming-table into feat/monitor-wiki-page-type/main 9c7e192f33

Reviewed-on: #54

admin merged commit e3054961ec into develop

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

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

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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/meta#55