From 970b7a4f71abbfb23ff28224864b104dbd78bf00 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Tue, 1 Sep 2026 12:10:55 +0800 Subject: [PATCH] =?UTF-8?q?docs(guidelines):=20=E5=91=BD=E5=90=8D=E7=B8=BD?= =?UTF-8?q?=E8=A1=A8=E5=8A=A0=E5=85=A5=20MONITOR=20=E9=A0=81=E5=9E=8B?= =?UTF-8?q?=E5=88=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What： - Wiki 頁命名總表新增 MONITOR 一列，擁有者是技能助理。 - 表下補三段說明：雜湊來源、為什麼不帶工具名稱、寫入語意。 - CHECK 那一段拿掉「是唯一例外」的斷言，改成指向新的機器層規則。 - 三份 manifest 的版本一起提升。 Why： - 總表是所有 wiki 頁命名的唯一來源。新型別沒登錄進來，各技能就沒有依據，只能各自猜。 - CHECK 原本寫著「是唯一例外」，指的是雜湊來源取主機名與帳號而不是存放庫。加了第二個同樣取法的型別之後，這句話就不成立了，留著會讓讀的人以為只有一個。 How： - MONITOR 的雜湊來源比照 CHECK，取主機名與登入帳號。助理巡檢的是一台機器，不是一個存放庫。 - 刻意不帶工具名稱，這一點與 TOOLING 相反。TOOLING 一支 CLI 一頁，因為每支 CLI 各有自己的已安裝 plugin 與 hook 接線；助理看的是整台機器一份心跳、一本待辦簿，不分 CLI。 - 監控頁一律附加，不覆寫。助理的寫入是背景行為，覆寫錯了沒人在現場。TOOLING 內容頁是每次盤點覆寫整頁，兩者語意相反，所以各自寫明白。 - 只動總表那一節，其餘章節不碰。 Who： 技能助理落地帶出來的頁型別需求，四個存放庫同一批改。 --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- references/guidelines.md | 16 +++++++++++++++- 4 files changed, 18 insertions(+), 4 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 11a31e3..8c23ef7 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.2.5", + "version": "0.2.6", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index 1b8902d..c648374 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.2.5", + "version": "0.2.6", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills", "jsc": { diff --git a/plugin.json b/plugin.json index 3a52971..7854b77 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.2.5", + "version": "0.2.6", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills/", "jsc": { diff --git a/references/guidelines.md b/references/guidelines.md index 8dffd63..b3a3f01 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -278,6 +278,7 @@ kiro 是唯一真的擋不了的，verdict 據實寫 `degraded`，不寫 `wired` | `REPORT` | `REPORT_CONTENTS` | `REPORT_{HASH}` | 報表目錄、工作報表頁（年、月、週、日各一頁） | jsc-log | | `SKILLSET` | `SKILLSET_CONTENTS` | `SKILLSET_{HASH}` | 技能組異動目錄、技能組異動報告頁（新增、更新、刪除、批次更新之後的驗證結果與改動清單） | jsc-meta | | `TOOLING` | `TOOLING_CONTENTS` | `TOOLING_{HASH}` | 技能盤點目錄、單機單 CLI 的技能盤點頁：一台機器上某一支 CLI 的已安裝 plugin 與版本、可用技能、hook 接線狀態 | jsc-meta | +| `MONITOR` | `MONITOR_CONTENTS` | `MONITOR_{HASH}` | 助理巡檢的監控頁。技能與 hook 每跑一次就留下事件，助理把事件收攏、判斷健康狀態、寫進這裡 | jsc-assist | `MAINTAIN` 沒有內容頁。維護登記全部寫在 `MAINTAIN_CONTENTS` 的表格裡：`jsc-sdlc:implement` 只往那一頁附加登記，`jsc-sdlc:maintain` 只讀那一頁再回寫「前次維護時間」，兩支都沒有產生 `MAINTAIN_{HASH}` 的步驟，`jsc-sdlc/templates/` 也沒有對應範本。總表以前列著這個內容頁，照著找只會找到一個不存在的頁。要補內容頁就先補技能步驟與範本，不能只在總表上寫著。 @@ -291,9 +292,10 @@ kiro 是唯一真的擋不了的，verdict 據實寫 `degraded`，不寫 `wired` `SKILLSET` 的雜湊來源就是被改動的 domain 存取庫 `{owner}/{repo}`，算法同上，由同一支 `jsc-gitea/tools/hash-id` 產生。 頁內**累積**歷次異動：每次異動附加一節，不覆蓋舊紀錄。要看一支技能改過幾次，就在同一頁上翻。 -`CHECK` 是唯一例外：它記的是一台執行環境，不是一個存取庫，所以雜湊來源為 `{主機名}/{登入帳號}`。 +`CHECK` 記的是一台執行環境，不是一個存取庫，所以雜湊來源為 `{主機名}/{登入帳號}`。 8 碼與 `H` 前綴的算法完全相同，由同一支 `jsc-gitea/tools/hash-id` 產生。 在沒有存取庫的目錄也跑得出體檢，是這個例外存在的原因。 +機器層的雜湊來源不只這一個，`MONITOR` 也照同一組取值，規則見下。 `TOOLING` 記的也是機器層事實，雜湊來源再多一段：`{主機名}/{工具名稱}/{登入帳號}`。 `{工具名稱}` 是 CLI 代號，取自 `jsc-cli/tools/detect-clis.sh` 輸出的第一欄，值為 `claude`、`codex`、`copilot`、`antigravity`、`kiro` 其中之一。 @@ -303,6 +305,18 @@ kiro 是唯一真的擋不了的，verdict 據實寫 `degraded`，不寫 `wired` 少了中間那一段，同一台機器上五支 CLI 會算出同一個雜湊，五份盤點互相覆蓋，最後只剩最後寫入的那一支，讀的人卻看不出被蓋掉。 帶上工具名稱，一支 CLI 就有一頁，換一支 CLI 重跑也不會動到別支的頁。 +`MONITOR` 的雜湊來源比照 `CHECK`，取 `{主機名}/{登入帳號}`。 +助理巡檢的是一台機器，不是一個存取庫。 +一台機器一頁，換一支 CLI 不另開頁。 +算法同上，由同一支 `jsc-gitea/tools/hash-id` 產生。 + +**為什麼不帶工具名稱。** 這一點與 `TOOLING` 相反。 +`TOOLING` 一支 CLI 一頁，因為每支 CLI 各有自己的已安裝 plugin 與 hook 接線。 +助理看的是整台機器一份心跳、一本待辦簿，不分 CLI，所以中間那一段不能加。 + +**監控頁一律附加，不覆寫。** 助理的寫入是背景行為，覆寫錯了沒人在現場。 +`TOOLING` 內容頁是每次盤點覆寫整頁，兩者的寫入語意剛好相反，不要混用。 + ## 審核檢查清單 新增或更新技能後逐項檢查，任一不符就修正：