feat/monitor-wiki-page-type/naming-table #54

2026-09-01T04:12:43Z

jiantw83 commented

2026-09-01 04:12:43 +00:00

摘要

需求描述：wiki 頁型別新增一種 MONITOR，給技能助理寫巡檢的監控頁。這一支負責把它登錄進技能準則的命名總表，並修掉一句因此不再成立的敘述。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/guidelines.md`	命名總表新增 `MONITOR` 一列；表下補雜湊來源、為什麼不帶工具名稱、寫入語意三段；`CHECK` 那段拿掉「是唯一例外」的斷言
三份 manifest	版本一起提升

設計重點

總表是唯一來源。 新型別沒登錄進來，各技能就沒有依據，只能各自猜。
「唯一例外」那句非改不可。 CHECK 原本寫著它是唯一雜湊來源取主機名與帳號的型別。加了第二個同樣取法的型別之後這句話就不成立，留著會讓讀的人以為只有一個。改法是保留 CHECK 的理由、刪掉不再成立的斷言、補一句指向新規則。
MONITOR 刻意不帶工具名稱，這一點與 TOOLING 相反。 TOOLING 一支 CLI 一頁，因為每支 CLI 各有自己的已安裝 plugin 與 hook 接線；助理看的是整台機器一份心跳、一本待辦簿，不分 CLI，所以中間那一段不能加。
寫入語意也與 TOOLING 相反。 監控頁一律附加、不覆寫——助理的寫入是背景行為，覆寫錯了沒人在現場；TOOLING 內容頁則是每次盤點覆寫整頁。兩者各自寫明白，避免照抄錯邊。
只動命名總表那一節，其餘章節不碰。第 166 行另有一句「kiro 是唯一例外」屬於 hook 事件那一節、與雜湊規則無關，刻意保留。

測試結果

lint-scripts.sh：exit 0。
lint-frontmatter.sh：exit 0（7 支，不是 exit 3）。
check-behaviors.sh：exit 0（對上 7 支技能，不是 exit 3）。
ste100-lint.sh：exit 0。
comment-scope.sh sweep：exit 0。
總表列數：13 列變 14 列，既有列的順序與內容一字未動。
全檔搜尋「唯一例外」，只剩 hook 事件那一節那一句，雜湊規則這邊沒有殘留。

前置 Push Request

無

## 摘要 - 需求描述：wiki 頁型別新增一種 `MONITOR`，給技能助理寫巡檢的監控頁。這一支負責把它登錄進技能準則的命名總表，並修掉一句因此不再成立的敘述。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/guidelines.md` | 命名總表新增 `MONITOR` 一列；表下補雜湊來源、為什麼不帶工具名稱、寫入語意三段；`CHECK` 那段拿掉「是唯一例外」的斷言 | | 三份 manifest | 版本一起提升 | ## 設計重點 - **總表是唯一來源。** 新型別沒登錄進來，各技能就沒有依據，只能各自猜。 - **「唯一例外」那句非改不可。** `CHECK` 原本寫著它是唯一雜湊來源取主機名與帳號的型別。加了第二個同樣取法的型別之後這句話就不成立，留著會讓讀的人以為只有一個。改法是保留 `CHECK` 的理由、刪掉不再成立的斷言、補一句指向新規則。 - **`MONITOR` 刻意不帶工具名稱，這一點與 `TOOLING` 相反。** `TOOLING` 一支 CLI 一頁，因為每支 CLI 各有自己的已安裝 plugin 與 hook 接線；助理看的是整台機器一份心跳、一本待辦簿，不分 CLI，所以中間那一段不能加。 - **寫入語意也與 `TOOLING` 相反。** 監控頁一律附加、不覆寫——助理的寫入是背景行為，覆寫錯了沒人在現場；`TOOLING` 內容頁則是每次盤點覆寫整頁。兩者各自寫明白，避免照抄錯邊。 - 只動命名總表那一節，其餘章節不碰。第 166 行另有一句「kiro 是唯一例外」屬於 hook 事件那一節、與雜湊規則無關，刻意保留。 ## 測試結果 - `lint-scripts.sh`：exit 0。 - `lint-frontmatter.sh`：exit 0（7 支，不是 exit 3）。 - `check-behaviors.sh`：exit 0（對上 7 支技能，不是 exit 3）。 - `ste100-lint.sh`：exit 0。 - `comment-scope.sh sweep`：exit 0。 - 總表列數：13 列變 14 列，既有列的順序與內容一字未動。 - 全檔搜尋「唯一例外」，只剩 hook 事件那一節那一句，雜湊規則這邊沒有殘留。 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-09-01 04:12:43 +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：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。

admin merged commit 9c7e192f33 into feat/monitor-wiki-page-type/main

2026-09-01 04:28:06 +00:00

admin deleted branch feat/monitor-wiki-page-type/naming-table

2026-09-01 04:28:06 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/meta#54