From d9d1dafe6e46aa64d749f917272ec399d39e756a Mon Sep 17 00:00:00 2001 From: Jeffery Date: Wed, 26 Aug 2026 10:46:11 +0800 Subject: [PATCH] =?UTF-8?q?docs(guidelines):=20=E6=BA=96=E5=89=87=E6=96=B0?= =?UTF-8?q?=E5=A2=9E=20CHECK=20=E8=88=87=20REPORT=20=E5=85=A9=E7=A8=AE=20w?= =?UTF-8?q?iki=20=E9=A0=81=E9=A1=9E=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 存取庫解析。 --- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- plugin.json | 2 +- references/guidelines.md | 11 +++++++++++ 4 files changed, 14 insertions(+), 3 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 2b6910e..e408ca7 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.0.10", + "version": "0.1.1", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills", "author": { diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index c292d9b..7daa0cc 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.0.10", + "version": "0.1.1", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills" } diff --git a/plugin.json b/plugin.json index bcc0181..cbfc4ad 100644 --- a/plugin.json +++ b/plugin.json @@ -1,6 +1,6 @@ { "name": "jsc-meta", - "version": "0.0.10", + "version": "0.1.1", "description": "技能組自我管理：新建、更新、刪除技能與技能準則", "skills": "./skills/" } diff --git a/references/guidelines.md b/references/guidelines.md index a475d5b..2cd4d4b 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -68,6 +68,8 @@ | `JSC_WIKI_REPO_LOG` | `LOG_CONTENTS`、`LOG_{HASH}` 所在的 `{owner}/{repo}` | 退回 `JSC_WIKI_REPO` | | `JSC_WIKI_REPO_LEARN` | `LEARN_CONTENTS`、`LEARN_{HASH}` 所在的 `{owner}/{repo}` | 退回 `JSC_WIKI_REPO` | | `JSC_WIKI_REPO_ERROR` | `ERROR_CONTENTS`、`ERROR_{HASH}` 所在的 `{owner}/{repo}` | 退回 `JSC_WIKI_REPO` | +| `JSC_WIKI_REPO_CHECK` | `CHECK_CONTENTS`、`CHECK_{HASH}` 所在的 `{owner}/{repo}` | 退回 `JSC_WIKI_REPO` | +| `JSC_WIKI_REPO_REPORT` | `REPORT_CONTENTS`、`REPORT_{HASH}` 所在的 `{owner}/{repo}` | 退回 `JSC_WIKI_REPO` | | `JSC_WIKI_REPO` | 未逐類設定時的共用 wiki `{owner}/{repo}` | 詢問使用者 | | `JSC_HOME` | Hook 資料目錄 | 預設 `~/.jsc` | @@ -116,11 +118,20 @@ | `LOG` | `LOG_CONTENTS` | `LOG_{HASH}` | 日誌目錄、工作日誌頁 | jsc-log | | `LEARN` | `LEARN_CONTENTS` | `LEARN_{HASH}` | 教訓目錄、技能教訓頁 | jsc-log | | `ERROR` | `ERROR_CONTENTS` | `ERROR_{HASH}` | 異常目錄、異常頁 | jsc-hooks | +| `CHECK` | `CHECK_CONTENTS` | `CHECK_{HASH}` | 體檢目錄、執行環境體檢頁 | jsc-cli | +| `REPORT` | `REPORT_CONTENTS` | `REPORT_{HASH}` | 報表目錄、工作報表頁（年、月、週、日各一頁） | jsc-log | `{HASH}` 一律為 `{owner}/{repo}`（必要時加上主題字串）的 SHA-1 前 8 碼，大寫。 若第一碼是 `0-9`、`A`、`B`、`C`，就改成 `H` 加上原 SHA-1 前 7 碼，總長仍維持 8 碼。 同一規則套用到所有目錄頁與內容頁。 +`REPORT` 用得到那個主題字串：雜湊來源為 `{owner}/{repo}/{期間}`，期間是 `daily`、`weekly`、`monthly`、`yearly` 其中之一。 +年、月、週、日各自一頁，每頁內依期間累積分節。 + +`CHECK` 是唯一例外：它記的是一台執行環境，不是一個存取庫，所以雜湊來源為 `{主機名}/{登入帳號}`。 +8 碼與 `H` 前綴的算法完全相同，由同一支 `jsc-gitea/tools/hash-id` 產生。 +在沒有存取庫的目錄也跑得出體檢，是這個例外存在的原因。 + ## 審核檢查清單 新增或更新技能後逐項檢查，任一不符就修正：