diff --git a/SKILLSET_CONTENTS.md b/SKILLSET_CONTENTS.md index 10cea74..1150fd0 100644 --- a/SKILLSET_CONTENTS.md +++ b/SKILLSET_CONTENTS.md @@ -1,36 +1,133 @@ # 技能組異動目錄 -每個 jsc domain 存放庫一頁，頁內累積歷次異動：新增、更新、刪除、批次更新之後的驗證結果與改動清單。頁名雜湊由 `jsc-gitea/tools/hash-id` 取 `{owner}/{repo}` 產生。 +> 由 `jsc-meta` 的 `skill-new`、`skill-update`、`skill-delete`、`skillset-update`、`skill-check` 共同維護。這是目錄頁 `SKILLSET_CONTENTS`。 +> 一個區塊代表一個 domain 存取庫。技能組有幾個 domain 被改過，就有幾個區塊。 +> 本頁落在 `JSC_WIKI_REPO_CONTENTS` 解出來的存取庫，不是內容頁那一個。解析鏈是 `JSC_WIKI_REPO_CONTENTS` → `JSC_WIKI_REPO` → exit 3，中間不退回 `JSC_WIKI_REPO_SKILLSET`。 +> 寫入一律用 `jsc-gitea/tools/wiki-contents.sh upsert SKILLSET 2 "SKILLSET_{HASH}" {區塊檔} templates/skillset-contents.md`：`` 填 `SKILLSET`，`` 填這一筆的 H2 標題，也就是內容頁頁名 `SKILLSET_{HASH}`，第四個參數是整個 H2 區塊的檔案，不是一列表格。 +> `` 填 `2`。這個參數填的是**舊表格裡持有「內容頁連結」那一欄的序號**，只在舊頁還是 markdown 表格、需要自動轉檔時才用得到：轉檔時工具從那一欄的連結網址取最後一段路徑當 H2 標題。序號要照**線上那一頁實際的欄位排法**數，不是照這份範本的欄位排法——線上 `SKILLSET_CONTENTS` 的舊表頭是 `| 存放庫 | 異動報告 | 目前版本 | 最後更新 |`，連結在第 2 欄，第 1 欄是 `plugins/ask` 這種純文字。填成 `1` 會把標題轉成 `plugins/ask`，跟鍵 `SKILLSET_{HASH}` 對不上，既有那一筆會被當成新的附加上去，同一筆變兩個區塊，舊區塊從此再也更新不到。頁面已經是條列格式時這個參數完全不影響結果。 +> 它讀回整頁、換掉 H2 標題相符的那個區塊、找不到才附加到頁尾，最後整頁寫回。不得手工改目錄頁。 +> `SKILLSET_{HASH}` 的 `{HASH}` 交給 `jsc-gitea/tools/hash-id` 產生，雜湊來源見 `jsc-meta/references/guidelines.md` 的「Wiki 頁命名總表」。 +> 連結寫法：所有連結一律 `[{文字}]({連結})`，網址放 `jsc-gitea/tools/gitea.sh wiki-url` 印出的絕對網址，不用 `[[...]]`。寫入前先把每個連結交給 `jsc-gitea/tools/link-check.sh` 驗證，結束碼 0 才寫入；驗證走 API，不看網頁狀態碼。 +> +> 欄位說明：一個區塊固定五條，順序照下面從上到下。 +> +> - 異動頁：`[SKILLSET_{HASH}]({連結})`，連結是 `gitea.sh wiki-url` 印出的絕對網址。與 H2 標題指的是同一頁，標題不放連結，這一條才放。 +> - 存取庫：被改動的 domain 存取庫 `{owner}/{repo}`，也就是那一頁的雜湊來源。 +> - 最近異動：最後一次異動的一句話摘要，與內容頁最新一節的「異動需求」同一句。 +> - 異動次數：該內容頁累積的節數。內容頁只附加不覆蓋，所以這個數字只會往上加。 +> - 最後更新：最後一次寫入內容頁的時間，與那一節的日期一致。 +> +> 為什麼 H2 標題寫頁名：頁名只由 `{owner}/{repo}` 決定，換主機名、`JSC_WIKI_REPO_SKILLSET` 改指別的存取庫、Gitea 的頁名編碼有差，都動不到它。鍵夠穩，`upsert` 才比得到既有那一筆；鍵一漂，同一個 domain 就多出第二個區塊，兩邊都寫得成功，也都看不出被分裂。 +> +> 為什麼連結要用絕對網址，還要先驗證：目錄頁與內容頁分屬不同存取庫。同 wiki 連結解到的是目錄頁自己那個存取庫，那裡沒有這一頁，點下去是 404。更麻煩的是它看起來像「頁沒寫成功」，實際上頁好好的，只是連結指錯地方，查的人會回去重寫一次已經寫好的頁。驗證則走 API，不看網頁狀態碼。私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判斷會把還在的頁判成死連結，接著被刪掉或改寫。 +> +> 寫入規則： +> +> - 一律走 `jsc-gitea/tools/wiki-contents.sh upsert`，鍵是 H2 標題 `SKILLSET_{HASH}`。 +> - 那支腳本先整頁讀回來，再逐個比對 H2 標題。 +> - 標題相同就整塊換掉，區塊裡的每一條都覆寫成本次結果。 +> - 找不到相同的標題，才附加一個新區塊。 +> - 只動自己那一個區塊，別人的區塊原樣保留。 +> - 禁止整頁覆蓋。這一頁是全部 domain 共用的索引，覆蓋等於刪掉別的 domain 的紀錄。 +> - 讀不到舊內容就中止，不附加區塊，也不寫入。 +> - 這一頁不留任何 markdown 表格。舊頁還是表格時由 `wiki-contents.sh` 自動轉成條列後寫回，不要手工搬。 +> - 先寫內容頁，成功了才回來更新這個區塊。目錄頁指向一個寫失敗的頁，比缺一筆更難查。 -| 存放庫 | 異動報告 | 目前版本 | 最後更新 | -| --- | --- | --- | --- | -| plugins/ask | [SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13) | 0.0.9 | 2026-08-31 | -| plugins/assist | [SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E) | 0.1.1 | 2026-09-02 | -| plugins/cli | [SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53) | 0.2.7 | 2026-08-31 | -| plugins/git | [SKILLSET_5C98A299CD288EB41EEBEE11E1F7395070609F69](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_5C98A299CD288EB41EEBEE11E1F7395070609F69) | 0.1.4 | 2026-08-31 | -| plugins/gitea | [SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091) | 0.2.1 | 2026-09-01 | -| plugins/hooks | [SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A) | 0.3.6 | 2026-09-01 | -| plugins/log | [SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073) | 0.1.4 | 2026-08-31 | -| plugins/meta | [SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2) | 0.2.6 | 2026-09-01 | -| plugins/pkg | [SKILLSET_36DEDDFCF10FAE0D0BF57BC7C6AA6219B2586A3C](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_36DEDDFCF10FAE0D0BF57BC7C6AA6219B2586A3C) | 0.0.9 | 2026-08-31 | -| plugins/review | [SKILLSET_F3320613CFAE2AD08949E97F29C5C1B4E8F1C62C](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_F3320613CFAE2AD08949E97F29C5C1B4E8F1C62C) | 0.1.2 | 2026-08-31 | -| plugins/sdlc | [SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39) | 0.2.8 | 2026-08-31 | +## SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13 -## 異動批次 +- 存放庫：plugins/ask +- 異動報告：[SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13) +- 目前版本：0.0.9 +- 最後更新：2026-08-31 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：2 -| 日期 | 類型 | 變更需求 | 涵蓋存放庫 | -| --- | --- | --- | --- | -| 2026-08-31 | 批次更新 | 盤點所有技能組，整理出所有技能的行為清單作為技能驗證的參考基準，日後技能異動都要同步更新；相依技能版本不符時不得跳過更新，改為阻擋執行 | 全部 10 個 | -| 2026-08-31 | 批次更新 | 修正 codex、copilot、antigravity、kiro 四支 CLI 的 hook 接線；四支都有能介入的 pre-tool 事件，過去接錯位置導致兩道閘門長期失效。同批修掉 6 支技能被靜默丟棄的 YAML 純量語法缺陷 | 7 個 | -| [SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_1C516D85C9D5F1417A8ECD8CEFBFB05225AD2B13) | plugins/ask | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 2 | 2026-09-02 13:37 | -| [SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E) | plugins/assist | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 4 | 2026-09-02 13:37 | -| [SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53) | plugins/cli | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 3 | 2026-09-02 13:37 | -| [SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091) | plugins/gitea | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 4 | 2026-09-02 13:37 | -| [SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A) | plugins/hooks | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 4 | 2026-09-02 13:37 | -| [SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073) | plugins/log | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 2 | 2026-09-02 13:37 | -| [SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2) | plugins/meta | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 4 | 2026-09-02 13:37 | -| [SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39) | plugins/sdlc | wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 | 3 | 2026-09-02 13:37 | +## SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E -## 維護規則 +- 存放庫：plugins/assist +- 異動報告：[SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_E0494A8CA74F9D21AF51BC724B66D313C784A31E) +- 目前版本：0.1.1 +- 最後更新：2026-09-02 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：4 -這一頁是所有存放庫共用的目錄，永遠先讀回再逐列更新，不整頁覆蓋——直接套範本會抹掉其他存放庫的列。內容頁先寫、目錄頁後寫，目錄才不會連到一個寫失敗的頁。 +## SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53 + +- 存放庫：plugins/cli +- 異動報告：[SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_BFC1D623D258F45212D00B4CEC30C9C9E30B0F53) +- 目前版本：0.2.7 +- 最後更新：2026-08-31 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：3 + +## SKILLSET_5C98A299CD288EB41EEBEE11E1F7395070609F69 + +- 存放庫：plugins/git +- 異動報告：[SKILLSET_5C98A299CD288EB41EEBEE11E1F7395070609F69](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_5C98A299CD288EB41EEBEE11E1F7395070609F69) +- 目前版本：0.1.4 +- 最後更新：2026-08-31 +- 最近異動：- +- 異動次數：- + +## SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091 + +- 存放庫：plugins/gitea +- 異動報告：[SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A9517501C8DD86B4ACED1F374F3A4998C1E4C091) +- 目前版本：0.2.1 +- 最後更新：2026-09-01 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：4 + +## SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A + +- 存放庫：plugins/hooks +- 異動報告：[SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_D79F03B5433CB4635656AC7AC44004C002A6A47A) +- 目前版本：0.3.6 +- 最後更新：2026-09-01 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：4 + +## SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073 + +- 存放庫：plugins/log +- 異動報告：[SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_A625EB394F74B67358606326BC529C74F7DF3073) +- 目前版本：0.1.4 +- 最後更新：2026-08-31 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：2 + +## SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2 + +- 存放庫：plugins/meta +- 異動報告：[SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_FB8DF0B5646689B45747957081FDFA56503E19A2) +- 目前版本：0.2.6 +- 最後更新：2026-09-01 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：4 + +## SKILLSET_36DEDDFCF10FAE0D0BF57BC7C6AA6219B2586A3C + +- 存放庫：plugins/pkg +- 異動報告：[SKILLSET_36DEDDFCF10FAE0D0BF57BC7C6AA6219B2586A3C](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_36DEDDFCF10FAE0D0BF57BC7C6AA6219B2586A3C) +- 目前版本：0.0.9 +- 最後更新：2026-08-31 +- 最近異動：- +- 異動次數：- + +## SKILLSET_F3320613CFAE2AD08949E97F29C5C1B4E8F1C62C + +- 存放庫：plugins/review +- 異動報告：[SKILLSET_F3320613CFAE2AD08949E97F29C5C1B4E8F1C62C](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_F3320613CFAE2AD08949E97F29C5C1B4E8F1C62C) +- 目前版本：0.1.2 +- 最後更新：2026-08-31 +- 最近異動：- +- 異動次數：- + +## SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39 + +- 存放庫：plugins/sdlc +- 異動報告：[SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39](https://gitea.jsc.idv.tw/knowledges/SKILLSET/wiki/SKILLSET_099C37C1B0D7AC4D77C5F8044CE2DFDB42F99D39) +- 目前版本：0.2.8 +- 最後更新：2026-08-31 +- 最近異動：wiki 目錄頁進專用存取庫、HASH 改為完整 40 碼 +- 異動次數：3