docs/meta-check-report-wiki-types #18

2026-08-26T02:46:37Z

jiantw83 commented

2026-08-26 02:46:37 +00:00

摘要

需求描述：新增的體檢技能與報表技能各帶一種 wiki 頁類型。準則的兩張總表是這些命名與環境變數的唯一真實來源，必須同步。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
`references/guidelines.md`	wiki 頁命名總表加入 `CHECK` 與 `REPORT`；環境變數表加入 `JSC_WIKI_REPO_CHECK` 與 `JSC_WIKI_REPO_REPORT`；補上兩者的雜湊來源規則
三份 manifest	版本同步 bump 到 0.1.1

設計重點

CHECK 是總表的唯一例外，而且寫明為什麼。它記的是一台執行環境，不是一個存取庫，所以雜湊來源用 {主機名}/{登入帳號}。體檢要能在沒有存取庫的目錄裡跑得出來，這是例外存在的理由。8 碼與 H 前綴的算法完全相同，仍由同一支 hash-id 產生。
REPORT 不是例外。它用既有的「必要時加上主題字串」規則，雜湊來源為 {owner}/{repo}/{期間}，年、月、週、日各一頁，每頁內依期間累積分節。
兩張總表分別列出擁有者：CHECK 屬 jsc-cli、REPORT 屬 jsc-log。頁面類型有明確擁有者，才不會兩支技能各寫各的。

測試結果

jsc-gitea/tools/check-wiki-rules.sh：OK，十一種類型全數通過（該腳本的改動在 plugins/gitea 的 PR）。
jsc-meta/tools/ste100-lint.sh：無違規。

前置 Push Request

plugins/gitea PR #20：準則寫進去的兩個類型，要有 gitea.sh 的白名單放行才真的能用。

## 摘要 - 需求描述：新增的體檢技能與報表技能各帶一種 wiki 頁類型。準則的兩張總表是這些命名與環境變數的唯一真實來源，必須同步。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `references/guidelines.md` | wiki 頁命名總表加入 `CHECK` 與 `REPORT`；環境變數表加入 `JSC_WIKI_REPO_CHECK` 與 `JSC_WIKI_REPO_REPORT`；補上兩者的雜湊來源規則 | | 三份 manifest | 版本同步 bump 到 0.1.1 | ## 設計重點 - **CHECK 是總表的唯一例外，而且寫明為什麼**。它記的是一台執行環境，不是一個存取庫，所以雜湊來源用 `{主機名}/{登入帳號}`。體檢要能在沒有存取庫的目錄裡跑得出來，這是例外存在的理由。8 碼與 `H` 前綴的算法完全相同，仍由同一支 `hash-id` 產生。 - **REPORT 不是例外**。它用既有的「必要時加上主題字串」規則，雜湊來源為 `{owner}/{repo}/{期間}`，年、月、週、日各一頁，每頁內依期間累積分節。 - 兩張總表分別列出擁有者：`CHECK` 屬 `jsc-cli`、`REPORT` 屬 `jsc-log`。頁面類型有明確擁有者，才不會兩支技能各寫各的。 ## 測試結果 - `jsc-gitea/tools/check-wiki-rules.sh`：`OK`，十一種類型全數通過（該腳本的改動在 `plugins/gitea` 的 PR）。 - `jsc-meta/tools/ste100-lint.sh`：無違規。 ## 前置 Push Request - [plugins/gitea PR #20](https://gitea.jsc.idv.tw/plugins/gitea/pulls/20)：準則寫進去的兩個類型，要有 `gitea.sh` 的白名單放行才真的能用。

jiantw83 added 1 commit 2026-08-26 02:46:37 +00:00

docs(guidelines): 準則新增 CHECK 與 REPORT 兩種 wiki 頁類型 d9d1dafe6e

What: wiki 頁命名總表加入 CHECK（擁有者 jsc-cli）與 REPORT（擁有者 jsc-log），環境變數表加入 JSC_WIKI_REPO_CHECK 與 JSC_WIKI_REPO_REPORT，並補上兩者的雜湊來源規則。
Why: 準則是這兩張總表的唯一真實來源。新頁類型只加進程式的白名單而沒寫進準則，下一次審核就會把它們當成漏網項目。
How: CHECK 記的是一台執行環境而不是存取庫，雜湊來源改用 {主機名}/{登入帳號}，是總表的唯一例外，明文寫清楚為什麼。REPORT 用既有的「加上主題字串」規則，雜湊來源為 {owner}/{repo}/{期間}，年月週日各一頁。
Who: wiki 頁面命名與 wiki 存取庫解析。

jiantw83 added a new dependency 2026-08-26 02:46:37 +00:00

plugins/gitea#20 - feat/gitea-check-report-wiki-types

admin merged commit 444ab9762b into develop

2026-08-26 02:51:30 +00:00

admin deleted branch docs/meta-check-report-wiki-types

2026-08-26 02:51:30 +00:00

jiantw83 referenced this pull request

2026-08-26 02:57:49 +00:00

release: develop 併入 master（CHECK、REPORT 準則） #19

Sign in to join this conversation.