jiantw83
5db1d8a608
What
- `templates/skillset-contents.md`：`SKILLSET_CONTENTS` 的版面從 markdown 表格改成一筆一個 H2 區塊，標題寫成該筆對應內容頁的實際頁名，欄位改成標題底下的一層條列。
- `templates/tooling-contents.md`：同樣轉條列，原本說明用的 `## ` 區段併進 `>` 引言，正式頁上才不會被讀成一筆假紀錄。
- `templates/skillset-page.md`、`templates/tooling-page.md`：引言補上目錄頁與內容頁的版面差別，內容頁本身維持圖表優先、不改版面。
- `README.md`：兩份目錄頁範本的說明同步改寫，兩份 `TOOLING` 範本語意相反那一段補上「版面也相反」。
Why
- 目錄頁是全部使用者共用的索引。表格一寬就得橫向捲、欄位一多就對不上表頭，而且併行寫入時只要有人少打一根豎線，整張表就散掉，別人那一筆跟著看不見。
- 條列式一筆一個區塊，寫入端只換自己那一塊，壞掉也只壞自己那一塊。
- 三個範本原本除了示範區塊之外還留著說明用的 `## ` 區段，轉條列後那種區段會在正式頁上被當成一筆紀錄讀進去。
How
- 一頁固定三段：H1 頁名、`>` 引言、然後每一筆一個 H2 區塊；區塊之間空一行，H2 與第一條之間空一行。
- 欄位在標題底下一行一條，格式 `- {欄位名}：{值}`，全形冒號，順序照原本的欄位從左到右，鍵那一欄照樣留一條。
- 寫入示例改成 `wiki-contents.sh upsert {TYPE} {鍵欄} "{內容頁頁名}" {區塊檔}`，並註明鍵欄是舊表格裡持有內容頁連結那一欄的序號、只供自動轉檔用、要照線上那一頁實際的欄位排法填。
- 頁上不留任何 markdown 表格，也不放 mermaid。
Who
- 影響照這兩個範本寫目錄頁的技能：`skill-new`、`skill-update`、`skill-delete`、`skillset-update`、`skill-check` 與 `tooling-guide`。
- 舊頁的轉檔與單一區塊 upsert 的實作不在本存取庫，本存取庫只提供範本與說明。
2.9 KiB
2.9 KiB
技能組異動 — {owner}/{repo}
由
jsc-meta的skill-new、skill-update、skill-delete、skillset-update、skill-check共同維護。這是內容頁SKILLSET_{HASH}。 一個 domain 存取庫一頁。雜湊來源是這個存取庫的{owner}/{repo}。 本頁落在JSC_WIKI_REPO_SKILLSET解出來的存取庫；目錄頁SKILLSET_CONTENTS在別的存取庫，版面也不同：那頁是大標題加條列，一筆一個 H2 區塊，本頁是內容頁，版面維持圖表優先。兩者不要混。 每次異動附加一節，不覆蓋舊紀錄。 要看一支技能改過幾次，就在這一頁上翻。 節的排列由新到舊，最新那一次放最上面。
{yyyy-MM-dd HH:mm} — {一句話寫這一次改了什麼}
| 項目 | 內容 |
|---|---|
| 日期 | {yyyy-MM-dd HH:mm} |
| 異動類型 | {skill-new、skill-update、skill-delete、skillset-update、skill-check 五選一} |
| 異動需求 | {一句話。與目錄頁「最近異動」那一條同一句} |
| 動到的技能 | {技能名，多支用頓號隔開；一支都沒動就寫「無」} |
| 改動檔案 | {存取庫內相對路徑，一行一個；一個檔都沒動就寫「無」} |
| PR 網址 | {絕對網址；沒開 PR 就寫「無」並說明原因} |
| 部署路線判定 | {部署路線、工作樹路線二選一，附 tools/deploy-route.sh 的結束碼} |
| 驗證結果 | {在新的 CLI 行程裡驗證的結果，寫實際看到的行為，不寫「已驗證」三個字了事} |
優化建議
只有
skill-check那一節要附這張表，其餘四支不附。 下一輪skill-check會先讀回這張表：「決議」欄寫著套用或延後的項目不重複掃、不重複問。 所以「決議」與「決議日期」兩欄不得留空，留空等於下一輪讀不懂，只好重問一次。
| 面向 | 技能 | 證據 | 建議 | 決議 | 決議日期 |
|---|---|---|---|---|---|
| {1 可平行化、2 可下放工具、3 重複來回、4 冗餘檢查、5 閘門時機、6 成本效率 六選一} | {技能名} | {file:line} | {一句話寫怎麼改} | {套用、延後、自訂 三選一} | {yyyy-MM-dd} |
| 欄位 | 內容 |
|---|---|
| 面向 | 六個優化面向之一，名稱與 skill-check 的面向表逐字相同 |
| 技能 | 被建議的技能，跨技能的建議一列一支 |
| 證據 | file:line，指得到才寫得進來 |
| 建議 | 一句話寫怎麼改。會削弱防護的建議要在這裡點名被削弱的是哪一道 |
| 決議 | 使用者當輪的決定：套用、延後、自訂。自訂 要在同一列的建議欄補上實際採用的做法 |
| 決議日期 | 做出決定那一天。決議欄寫 延後 的項目，下一輪照這個日期認定為已決議，照樣不重問 |
{yyyy-MM-dd HH:mm} — {上一次異動的一句話}
（上一次的內容原樣留著，不改、不刪。）