From c593803ed554cdccc0b010582ae4d120083d6553 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 28 Aug 2026 15:33:13 +0800 Subject: [PATCH] =?UTF-8?q?docs(tooling-guide):=20=E6=9B=B4=E6=96=B0=20REA?= =?UTF-8?q?DME=20=E6=8A=80=E8=83=BD=E8=88=87=E5=B7=A5=E5=85=B7=E7=9B=AE?= =?UTF-8?q?=E9=8C=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index bc5845e..4d08b0c 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,10 @@ Marketplace 統一為 `jsc`（https://gitea.jsc.idv.tw/plugins/meta.git），安 同步上游 speak-human-tw 的語言規則：比對 `references/ste100.md` 釘住的上游版本，有新版就萃取適用的變更、逐項決策樹確認、更新 lint 樣式、全庫重掃、bump manifest，最後開 PR。適合列為本 repo 的維護方式。 +### `tooling-guide` + +盤點目前支援的 plugins、skills、hooks 管理與使用路徑，產出技能組基礎指引。適合建立技能組地圖、支援清單、hook 管理總覽與新人交接資料；安裝、更新、刪除、稽核與修復改用對應技能。 + ## 參考與工具 @@ -59,6 +63,7 @@ Marketplace 統一為 `jsc`（https://gitea.jsc.idv.tw/plugins/meta.git），安 | `tools/ste100-lint.sh` | 語言規則的機檢工具：中國用語、中文句內半形標點、AI 套話、簡體字、中文並列斜線；命中 exit 1 | | `tools/sync-domains.sh` | 依 Gitea 正本 marketplace 把所有 domain 存取庫 clone 或 pull 到本機，印出 `domainpath`；**只有 exit 0 代表全部到位且最新**，exit 3 代表有存取庫跳過或 pull 失敗（stderr 列路徑），exit 2 代表有 domain clone 失敗 | | `tools/list-skills.sh` | 列出正本 marketplace 上各 domain 存取庫的技能，印出 `domainnamedescription`；不在正本清單上的存取庫不列 | +| `tools/inventory-tooling.sh` | 盤點目前支援的 plugins、skills、tools、hooks，輸出技能組基礎指引 Markdown | | `tools/sync-marketplace.sh` | 寫入或更新兩份正本 marketplace 的 plugin 條目，再複製到每個 domain 存取庫（保證位元組一致）。**需要 python3**（json 模組改 JSON），缺 python3 不寫檔並 exit 1；存取庫不在本機 exit 3 | | `tools/sync-skill-manifest.sh` | 同步 domain README 的「Skills 目錄」，並 bump 三份 manifest 的 version；`minor` 與 `patch` 不得超過 `9`，`major` 可以超過 `9` | | `tools/find-skill-refs.sh` | 盤點一個技能在正本 marketplace 各 domain 存取庫裡的引用檔案（不掃非技能組存取庫與點開頭目錄）；技能名稱為純子字串比對，命中要逐檔確認；零命中 exit 1，掃描失敗 exit 3 |