 jiantw83
|
c40b561589
|
feat(wiki): 目錄頁專用存取庫、HASH 去除截短與 H 前綴
What：CONTENTS 成為第 15 種頁面類型，解析鏈為 JSC_WIKI_REPO_CONTENTS 到
JSC_WIKI_REPO，刻意不退回型別變數。hash-id 拿掉 8 碼截短與 H 前綴改寫，只留大寫
轉換，輸出完整 40 碼；空輸入改成用法錯誤。新增 page-name.sh、wiki-contents.sh、
migrate-wiki.sh 與 wiki-delete 子命令。
Why：H 前綴會命中 16 個首碼裡的 13 個，還丟掉第 8 碼，把有效熵壓到 28 位元，而且
全庫查不到任何理由紀錄。目錄頁的整列 upsert 原本 14 處只有一處寫成程式，同一段判斷
做 14 次，錯一次就少一筆紀錄。
How：頁名樣式仍收 H 加 7 碼的舊頁，遷移期間讀得到舊頁。wiki-contents.sh 建新頁時
剝掉範本的示範列，否則每個目錄頁第一次建立都會留一列佔位死連結。migrate-wiki.sh
預設只印對照表，--apply 先寫新頁、確認寫成、才刪舊頁；孤兒頁只列不猜，因為 SHA-1
不可逆，新頁名只能靠候選鍵正推。
Who：jsc-gitea
|
2026-09-02 11:02:07 +08:00 |
|
|
jiantw83
|
8467b89a09
|
feat(wiki): 頁型別新增 MONITOR
What：
- resolve_wiki_repo 的型別白名單與檔頭註解加上 MONITOR，check-wiki-rules.sh 的 TYPES 一併加入。
- README 的兩處型別列舉加上 MONITOR，環境變數表補一列 JSC_WIKI_REPO_MONITOR。
- wiki 技能的 allowed types 與行為清單的呼叫端補上這個型別與它的擁有者。
- 三份 manifest 的版本一起提升。
Why：
- 技能助理要把巡檢結果寫進 wiki，落點就是監控頁。型別不在白名單裡，wiki-repo 會直接回「unknown wiki type」而拒絕解析，助理連寫都寫不出去。
- 型別串散在五個檔案，只改一處會讓解析通過但檢核工具漏掉，或反過來。所以一次改齊。
How：
- MONITOR 放在型別串尾端，接在 TOOLING 之後。既有順序是依用途分群，不是字母序，所以不重排。
- 環境變數的規則完全沿用既有型別：先讀 JSC_WIKI_REPO_MONITOR，再退回 JSC_WIKI_REPO，不得跨型別代用。這一條由 resolve_wiki_repo 統一處理，新型別自動繼承，不必另寫分支。
- 雜湊來源的規則不寫在這個存放庫。README 已載明雜湊規則的唯一來源是技能準則的命名總表，這裡不複述。
- wiki 技能的 description 原本逐一列舉呼叫端，已經接近長度上限。這次改成括號標注頁型的濃縮寫法，加了一個呼叫端之後整行反而變短，句數維持在上限內。
Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。
|
2026-09-01 12:10:40 +08:00 |
|
|
jiantw83
|
bedbdc227f
|
feat(references): 新增 jsc-gitea 技能行為清單
What：新增 references/behaviors.md。這一頁替 jsc-gitea 的五支技能各留一節，依序是 html-export、html-style、repo-sync、wiki、wiki-to-issue。每一節放一張五列表，欄位固定為觸發時機、關鍵步驟、外部呼叫、完成條件、可驗證跡象。
Why：技能驗證原本沒有共同的比對基準，每次都要回頭讀 SKILL.md 反推該有的行為。這一頁把行為寫成基準，驗證時直接比對。清單放在本存放庫而不是集中到 meta，技能改動與清單才會落在同一個 PR，內容不會漂移，也不用跨存放庫開兩條 PR 互卡。
How：逐支技能盤點，從 SKILL.md 與 skills 底下的腳本讀出實際行為。外部呼叫欄逐一列出用到的工具腳本、被呼叫的技能與 Gitea API，例如 tools/gitea-link.sh、tools/html-style.sh、tools/html-render.sh、tools/repo-sync.sh、tools/issue.sh、tools/hash-id。可驗證跡象欄一律寫看得到的產物，例如 HTML 檔落點、wiki 頁名、議題網址、設定檔內容。稽核時修正 html-style 一處，設定檔格式從空白分隔改成實際的 {種類}={版型},{風格}。表格欄位依 jsc-meta/tools/check-behaviors.sh 的程式層檢查對齊。
Who：jsc-gitea 的技能驗證參考基準，涵蓋 html-export、html-style、repo-sync、wiki、wiki-to-issue 五支技能。
|
2026-08-31 13:40:54 +08:00 |
|