jiantw83andClaude Fable 5
30687d5eea
What（改了什麼）： - 新增 skills/skillset-update/SKILL.md：五步流程——決策樹確認變更範圍 → 依 Gitea 正本 marketplace 同步全部 domain repo → 每個受影響 domain 各派一個 sub agent 套用變更（含 README「Skills 目錄」同步與三份 manifest 版本遞增）→ 逐技能過 guidelines 審核檢查清單 → 每個受影響 repo 各開一個 PR。 - README.md「Skills 目錄」新增 skillset-update 條目，並同步更新 skill-update 與 skill-delete 的流程描述（marketplace 先行、補 clone、深度刪除驗證）。 Why（為什麼改）： - 既有 skill-update 一次只能改一個技能；跨多技能、多 domain 的規則變更（如共用流程步驟調整）需要逐 repo 重複操作，容易漏改。 - README 需與技能實際流程保持同步，此為 guidelines 審核檢查清單的必要項目。 How（怎麼改）： - 依 guidelines.md 準則撰寫：英文 description 含觸發與不觸發時機（單一技能改用 skill-update）、Gitea 操作一律走 jsc-gitea/tools/gitea.sh、提問一律走 jsc-ask:ask、需隔離的步驟標明 MUST run as a sub agent、每步標明完成條件。 - README 條目與各技能一節的敘述對齊 SKILL.md 的實際流程。 - 註：README.md 的三處變更位於同一個 diff hunk、無法乾淨拆分，故整檔併入本群組（本群組為最後一個觸及 README 的 feature 群組）。 Who（影響哪個功能／使用者）： - 需要對整個 jsc 技能組做橫向規則變更的維護者；單一技能更新的使用者不受影響（仍走 skill-update）。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
59 lines
3.8 KiB
Markdown
59 lines
3.8 KiB
Markdown
# 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 描述需求自動觸發。
|
||
|
||
<!-- JSC-SKILLS:START -->
|
||
|
||
### `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。
|
||
|
||
### `ste100-sync`
|
||
|
||
同步上游 speak-human-tw 的語言規則：比對 `references/ste100.md` 釘住的上游版本，有新版就萃取適用的變更、更新 lint 樣式、全庫重掃，最後開 PR。適合列為本 repo 的維護方式。
|
||
|
||
<!-- JSC-SKILLS:END -->
|
||
|
||
## 參考與工具
|
||
|
||
| 檔案 | 用途 |
|
||
| --- | --- |
|
||
| `references/guidelines.md` | 技能準則唯一來源，所有 domain 的 AGENTS.md 都指向這裡 |
|
||
| `references/ste100.md` | STE100 擬人台灣感語言規則唯一來源（改寫自 speak-human-tw，MIT） |
|
||
| `tools/ste100-lint.sh` | 語言規則的機檢工具：中國用語、中文句內半形標點、AI 套話；命中 exit 1 |
|
||
|
||
## 相關 domain
|
||
|
||
- [`jsc-ask`](https://gitea.jsc.idv.tw/plugins/ask)：決策樹問詢
|
||
- [`jsc-git`](https://gitea.jsc.idv.tw/plugins/git)：完成後的 Push Request
|