Files
meta/README.md
T
jiantw83andClaude Fable 5 ef2577c011 feat(skill-check): 新增 skill-check 技能——例行稽核整個技能組是否符合準則
What(改了什麼):
- 新增 skills/skill-check/SKILL.md:六步流程——依 Gitea 正本 marketplace 同步全部 domain repo → 每個 domain 各派一個 sub agent 對照 guidelines 審核檢查清單稽核 → 不符項目逐項走 jsc-ask:ask 決策樹確認(套用建議修正/略過/自訂修正,每個選項標明影響範圍)→ 每個受影響 repo 各派一個 sub agent 套用修正(含 README「Skills 目錄」同步與三份 manifest 版本遞增)→ 複檢至全數通過 → 逐 repo 以 jsc-git:pr 開 PR。
- README.md「Skills 目錄」新增 skill-check 條目,並標明與 skillset-update 的分工:無變更需求走 skill-check,有變更需求走 skillset-update。

Why(為什麼改):
- 既有 skillset-update 以「一份變更需求」為前提;準則本身演進後,技能組缺少「無變更需求時」的例行體檢入口,不符項目只能等到下次改動才被發現。
- 稽核與修正拆成獨立技能,可排入定期維護,讓整個技能組持續符合 guidelines.md。

How(怎麼改):
- 依 guidelines.md 準則撰寫:英文 description 含觸發與不觸發時機(套用變更需求改用 skillset-update、單一技能改用 skill-update)、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。
- 複檢失敗時明定回到決策樹確認步驟,直到檢查清單全數通過才開 PR。

Who(影響哪個功能/使用者):
- 負責 jsc 技能組例行維護的維護者;一般技能新增、更新、刪除的使用者不受影響(仍走 skill-new/skill-update/skill-delete)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-21 09:25:59 +00:00

4.1 KiB
Raw Blame History

jsc-meta — 技能組自我管理

jsc 技能組的 meta domain:新建、更新、刪除技能的流程,以及全技能組的準則單一來源 references/guidelines.md(命名、description 規則、hook / 工具 / sub agent 下放、語言、環境變數、wiki 頁命名總表、審核檢查清單)。

安裝 / 更新 / 移除

Marketplace 統一為 jsc(https://gitea.jsc.idv.tw/plugins/jsc.git),安裝 token 為 jsc-meta@jsc。每個指令一行:

CLI 安裝 更新 移除
claude claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && claude plugin install jsc-meta@jsc claude plugin marketplace update jsc && claude plugin update jsc-meta@jsc claude plugin uninstall jsc-meta@jsc
codex codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && codex plugin add jsc-meta@jsc codex plugin marketplace upgrade jsc codex plugin remove jsc-meta@jsc
copilot copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && copilot plugin install jsc-meta@jsc copilot plugin marketplace update jsc && copilot plugin update jsc-meta@jsc copilot plugin uninstall jsc-meta@jsc
antigravity git clone https://gitea.jsc.idv.tw/plugins/meta.git ~/plugins/meta && agy plugin install ~/plugins/meta git -C ~/plugins/meta pull && agy plugin uninstall jsc-meta && agy plugin install ~/plugins/meta agy plugin uninstall jsc-meta
kiro kiro-cli plugin marketplace add https://gitea.jsc.idv.tw/plugins/jsc.git && kiro-cli plugin install jsc-meta@jsc kiro-cli plugin marketplace update jsc && kiro-cli plugin update jsc-meta@jsc kiro-cli plugin uninstall jsc-meta@jsc

antigravity 不支援 gitea URL 安裝,改用本地 clone 路徑。批次操作五個 CLI:使用 /jsc-cli:deploy。

Skills 目錄

呼叫方式:Claude / Antigravity /jsc-meta:{name};Codex ${name};Copilot / Kiro 描述需求自動觸發。

skill-new

新建技能:決策樹問細節(目標、觸發、輸入輸出、domain)→ 缺 domain 時依 template 結構建立新存取庫 → sub agent 依準則產生技能 → 審核清單自檢 → PR。

skill-update

更新技能:先查 Gitea 正本 marketplace 取得 domain 清單並補 clone 缺少的存取庫,列出全部技能 → 使用者選擇 → 決策樹問更新細節 → 更新後依審核檢查清單逐項檢查,不符就回到詢問 → PR。

skill-delete

刪除技能:先查 Gitea 正本 marketplace 取得 domain 清單並補 clone 缺少的存取庫,列出全部技能 → 使用者選擇 → sub agent 盤點關聯檔案 → 逐檔判斷是否需修正以維持功能(需要就決策樹問修正細節並依準則檢查)→ 刪除 → sub agent 實地檢查各 CLI 的技能與 hook 保存位置,確認沒有殘留 → PR。

skillset-update

批次更新——把一份變更需求套用到整個技能組的多個技能/domain,逐 repo 開 PR;單一技能改用 skill-update。

skill-check

例行稽核——沒有變更需求時,把整個技能組逐一對照準則的審核檢查清單:sub agent 逐 domain 稽核 → 不符項目逐項決策樹確認 → sub agent 套用修正並複檢 → 逐 repo 開 PR。有變更需求改用 skillset-update。

ste100-sync

同步上游 speak-human-tw 的語言規則:比對 references/ste100.md 釘住的上游版本,有新版就萃取適用的變更、更新 lint 樣式、全庫重掃,最後開 PR。適合列為本 repo 的維護方式。

參考與工具

檔案 用途
references/guidelines.md 技能準則唯一來源,所有 domain 的 AGENTS.md 都指向這裡
references/ste100.md STE100 擬人台灣感語言規則唯一來源(改寫自 speak-human-tw,MIT)
tools/ste100-lint.sh 語言規則的機檢工具:中國用語、中文句內半形標點、AI 套話;命中 exit 1

相關 domain