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 的實作不在本存取庫，本存取庫只提供範本與說明。
4.0 KiB
4.0 KiB
技能盤點 — {主機名}/{工具名稱}/{登入帳號}
由
jsc-meta:tooling-guide維護。這是盤點頁TOOLING_{HASH}。 這頁記的是「現在這台機器上這支 CLI 長什麼樣」。每次盤點覆寫整頁，不保留歷史。 覆寫是刻意的：舊的安裝內容與接線狀態早就不成立，留著只會讓人照著過期的事實下判斷。 目錄頁TOOLING_CONTENTS的規則相反：那頁是大標題加條列，一筆一個 H2 區塊，每次只更新自己那一個區塊，兩者不要混用。本頁是內容頁，版面維持圖表優先。 要看技能組歷次異動請翻SKILLSET_{HASH}，累積紀錄在那一頁。
本次盤點
| 項目 | 內容 |
|---|---|
| 盤點時間 | {yyyy-MM-dd HH:mm} |
| 主機 | {主機名} |
| 工具 | {claude、codex、copilot、antigravity、kiro 五選一} |
| 帳號 | {登入帳號} |
| 資料來源 | meta/tools/inventory-tooling.sh 單次執行的輸出 |
| plugins 根目錄 | {絕對路徑} |
| marketplace | {絕對路徑} |
全頁事實出自上面那一次執行。同一趟不重跑
list-skills.sh、detect-clis.sh與wire-cli.sh status，避免同一件事出現兩個答案。
資料新鮮度
對應輸出的 Source freshness 一節。
| 項目 | 狀態 |
|---|---|
| 本機 domain 清單 | {synced、stale accepted、blocked 三選一} |
| marketplace | {絕對路徑} |
現況摘要
對應輸出的 現況摘要 一節。
| 項目 | 數量 |
|---|---|
| 已註冊 plugin domain | {n} |
| 已掃到技能 | {n} |
| 已偵測 CLI | {n} |
已安裝 plugin
對應輸出的 Supported plugins 一節。
| domain | 版本 | 本機路徑 |
|---|---|---|
| {domain} | {版本或「缺本機存取庫」} | {絕對路徑} |
可用技能
對應輸出的 Supported skills 一節。
| domain | skill | 用途 |
|---|---|---|
| {domain} | {技能名} | {一句用途} |
已偵測 CLI
對應輸出的 Supported CLIs 一節。只留這一頁對應的那支 CLI，其餘 CLI 各自有自己的盤點頁。
| CLI | 執行檔 | 版本 |
|---|---|---|
| {工具名稱} | {絕對路徑} | {版本字串} |
可用工具
對應輸出的 Supported tools 一節。
| domain | tool | 用途 |
|---|---|---|
| {domain} | {腳本檔名} | {檔頭第二行的說明} |
hook 管理
對應輸出的 Hook management 一節。
| hook | 用途 |
|---|---|
| {腳本檔名} | {檔頭第二行的說明} |
hook 接線狀態
對應輸出的 Hook wiring status 一節。只留這一頁對應的那支 CLI。
| CLI | 結束碼 | 狀態 |
|---|---|---|
| {工具名稱} | {n} | {狀態字串；查不到就寫「未知狀態，結束碼 {n}」} |
plugin 與技能管理
對應輸出的 Plugin and skill management 一節。
| 需求 | 入口 |
|---|---|
| 新增技能 | jsc-meta:skill-new |
| 更新單一技能 | jsc-meta:skill-update |
| 批次更新技能組 | jsc-meta:skillset-update |
| 刪除技能 | jsc-meta:skill-delete |
| 安裝、更新、移除整組 plugin | jsc-cli:deploy |
| 例行稽核 | jsc-meta:skill-check |
| 重新接線 hook | jsc-hooks:hooks-install |
例行檢查
對應輸出的 Operational checks 一節。
| 檢查 | 負責的技能或 hook |
|---|---|
| 體檢目前環境 | jsc-cli:doctor |
| 修復體檢項目 | jsc-cli:setup |
| 版本前置檢查 | jsc-hooks/hooks/version-guard.sh |
| 部署後重啟閘門 | jsc-hooks/hooks/restart-gate.sh |
| 語言提示與掃描 | jsc-hooks/hooks/ste100-guard.sh、jsc-hooks/hooks/lang-guard.sh |
| 註解範圍檢查 | jsc-hooks/hooks/comment-scope.sh |
使用時機
對應輸出的 Use this when 一節。
- 這頁只回答「這台機器這支 CLI 現在裝了什麼」。
- 要動手安裝、更新或修復，照上面兩張表找對應的入口。
- 盤點時間離現在太久就重跑一次
jsc-meta:tooling-guide，不要拿舊頁當現況。
已知限制
| 限制 | 說明 |
|---|---|
| {限制項目} | {為什麼這一項在這台機器上查不到或不適用} |