釋出：目錄頁改條列式、收尾事件回報與連結驗證 #29

2026-09-04T05:01:05Z

jiantw83 commented

2026-09-04 05:01:05 +00:00

摘要

需求描述：develop 壓著九筆沒釋出，這台機器上一筆都沒生效。deploy.sh clone 的是預設分支，沒進 master 的東西部署不到。
計畫名稱：無
計畫頁：無
分析頁：無

這一批的內容

變更	為什麼
問詢目錄頁改條列式，並修正鍵欄位參數	目錄頁不再是 markdown 表格，一個內容頁一個大標題區塊
收尾寫一筆 `skill-end` 事件	執行狀態要回報得到助理，助理才看得出一支技能中途斷掉
連結一律寫成絕對網址並先驗證	wiki 的雙中括號寫法只在同一個 wiki 內解得開，跨庫寫就是死連結而且不會報錯

版號 0.1.0 到 0.1.3。

這一批的邊界

程式碼與文件都是既有的，這張只做釋出，一個字都沒改。

前置 Push Request

無

## 摘要 - 需求描述：develop 壓著九筆沒釋出，這台機器上一筆都沒生效。`deploy.sh` clone 的是預設分支，沒進 master 的東西部署不到。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 這一批的內容 | 變更 | 為什麼 | | --- | --- | | 問詢目錄頁改條列式，並修正鍵欄位參數 | 目錄頁不再是 markdown 表格，一個內容頁一個大標題區塊 | | 收尾寫一筆 `skill-end` 事件 | 執行狀態要回報得到助理，助理才看得出一支技能中途斷掉 | | 連結一律寫成絕對網址並先驗證 | wiki 的雙中括號寫法只在同一個 wiki 內解得開，跨庫寫就是死連結而且不會報錯 | 版號 0.1.0 到 0.1.3。 ## 這一批的邊界程式碼與文件都是既有的，這張只做釋出，一個字都沒改。 ## 前置 Push Request - 無

jiantw83 added 9 commits 2026-09-04 05:01:05 +00:00

feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 6bb37e5b11

取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。

chore(plugin 版本): 三份 manifest 升版至 0.1.1 12e79ee3af

Merge pull request '連結一律寫成 [文字](絕對網址)，並在寫入前驗證連得到' (#26 ) from feat/link-verification/main into develop 1600b11998

Reviewed-on: #26

feat(狀態回報): 收尾寫一筆 skill-end 事件 df317adad8

現行紀錄只記「被叫用」，沒有成敗也沒有結束碼。跑完整輪的技能與開場就
中止的技能，在紀錄裡長得一模一樣。

start 由技能用量 hook 順手發，不必改技能文件。end 只能由技能自己在收尾
步驟寫——hook 接在技能工具呼叫上，而實際工作發生在之後的模型輪次，它在
原理上看不到成敗。有 start 沒有配對的 end，就是那一輪中止了。

status 五選一，每支技能各自寫明什麼情況選哪一個。找不到回報腳本就安靜
跳過，回報失敗一律不改變技能自己的結論。

chore(plugin 版本): 三份 manifest 升版至 0.1.2 891e64a2ac

Merge pull request '收尾寫一筆 skill-end 事件，執行狀態才回報得到助理' (#27 ) from feat/status-report into develop fd690aa46e

Reviewed-on: #27

feat(ask): 問詢目錄頁改條列式並修正 key-col 參數 e8294f3891

What：
把問詢目錄頁 `QUESTION_CONTENTS` 的呈現格式從 markdown 表格改成條列式——每個存取庫一個 H2 區塊，H2 標題就是該存取庫問詢紀錄頁的頁名 `QUESTION_{HASH}`，欄位改成標題底下一層條列 `- {欄位名}：{值}`，順序維持存取庫名稱、問詢紀錄、最後更新，整頁不再留任何 markdown 表格。同一輪把 `wiki-contents.sh upsert QUESTION` 的呼叫參數從 `1 {owner}/{repo}` 改成 `2 QUESTION_{HASH}`。改動落在 `templates/question-contents.md` 的版面與參數語意、`skills/ask/SKILL.md` 與 `references/behaviors.md` 的步驟敘述與可驗證跡象，以及 `README.md` 的技能描述。

Why：
表格版面一列塞滿所有欄位，欄位一長就難讀，每一筆的鍵也埋在儲存格裡；改成一筆一個 H2 區塊之後，鍵就是標題文字，人與工具都直接看得出哪一筆對應哪一個內容頁。`key-col` 原本填 `1`，指到的是純文字的存取庫名稱欄：舊表格自動轉條列時，工具會拿那一欄的連結產生 H2 標題，填 `1` 只會做出 `## plugins/meta` 這種標題，比不到鍵 `QUESTION_{HASH}`，既有那一筆會被當成新的附加上去，同一個存取庫在頁面上出現兩個區塊，舊區塊從此再也更新不到。

How：
`templates/question-contents.md` 的範本主體從表頭加資料列換成 `## QUESTION_{HASH}` 加三條 bullet，引言補上版面段與參數語意段，寫明 `{key}` 是 H2 標題文字、第四個參數帶的是整個區塊的 markdown 而不是單列。`skills/ask/SKILL.md` 把目錄頁那幾條的 row 敘述全部改成 block，呼叫式改為 `upsert QUESTION 2 QUESTION_{HASH} {block-file} templates/question-contents.md`，並說明 `key-col` 為什麼固定是 `2`、填 `1` 會壞成什麼樣，另外在 `wiki-contents.sh` 退 1 的分支補上「頁面上還沒有自己那個區塊不算失敗，那是附加的情形」。`references/behaviors.md` 的關鍵步驟補上區塊檔的組法與參數語意，外部呼叫改成單一 H2 區塊的讀取、合併、寫回，可驗證跡象改成檢查該區塊三條 bullet 的齊全度、順序、全形冒號與整頁不留表格，並補上舊表格轉條列後 H1 與 `>` 引言原樣保留、原有資料一筆不少。`README.md` 的技能描述同步改成條列式的說法。實際的轉檔與 upsert 邏輯在另一個存取庫的 `gitea/tools/wiki-contents.sh`，本存取庫只調整敘述與範本。

Who：
屬於 wiki 目錄頁一律改條列式呈現的需求，`ask` 這一支負責 `QUESTION_CONTENTS` 的範本與敘述。`key-col` 修正是同一個需求能正確落地的必要條件，且與版面敘述改在同一段文字上，無法拆成獨立提交。

chore(ask): 插件版本號更新為 0.1.3 9b4100060e

What：
把 `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 三份 manifest 的 `version` 從 `0.1.2` 改成 `0.1.3`，三份檔案的其餘欄位一字不動。

Why：
本輪技能敘述與範本有行為變更，安裝端是靠 manifest 的 `version` 判斷要不要更新，版本號不動的話已經安裝的機器不會拉到新版。三份 manifest 分別給不同的 CLI 讀取，必須一起前進，只改其中一份會讓各 CLI 認到的版本不一致。

How：
只改三份 manifest 的 `version` 欄位，內容與敘述、範本無關，因此不與需求本身的變更混在一起，獨立成一個提交，讓發版動作在歷史上單獨可追、需要時也能單獨回退。

Who：
屬於插件發版維護，隨本輪目錄頁條列式需求一起放行，本身不改任何技能行為。

Merge pull request '問詢目錄頁改成大標題加條列，鍵改用問詢紀錄頁頁名' (#28 ) from feat/contents-list/main into develop 4ff426ca95

Reviewed-on: #28

admin approved these changes 2026-09-04 05:02:11 +00:00

admin merged commit 3b6d084980 into master

2026-09-04 05:02:14 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/ask#29