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 的實作不在本存取庫，本存取庫只提供範本與說明。
130 lines
4.0 KiB
Markdown
130 lines
4.0 KiB
Markdown
# 技能盤點 — {主機名}/{工具名稱}/{登入帳號}
|
|
|
|
> 由 `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`，不要拿舊頁當現況。
|
|
|
|
## 已知限制
|
|
|
|
| 限制 | 說明 |
|
|
| --- | --- |
|
|
| {限制項目} | {為什麼這一項在這台機器上查不到或不適用} |
|