refactor(plugin 命名空間): generic 改名 shared
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: plugins-install
|
||||
description: 一次把 JSC 的三個 plugin（jsc-code／jsc-doc／jsc-persona）安裝或更新到一個或多個 AI 助理，可同時處理 Claude Code、Codex、GitHub Copilot CLI、Antigravity 四家原生 plugin CLI 與 OpenCode（複製 skills 目錄）；沒指定時偵測本機裝了哪些 CLI 並讓使用者多選，每個 plugin 先判斷已安裝或未安裝，未安裝就安裝、已安裝就更新到最新，最後以「助理 × plugin」的表格回報結果與版本。當使用者說要安裝所有 jsc plugin、一次更新全部 skill 套件、把 code／doc／persona 都裝起來、要同時更新好幾個 CLI、換新機器要把 plugin 都補齊、或問怎麼一次更新所有 plugin 時觸發。不適用於：移除 plugin（用 /jsc-generic:plugins-uninstall）、只處理單一 plugin（直接照該 plugin README 的安裝章節）、安裝非 JSC 的第三方 plugin。
|
||||
description: 一次把 JSC 的三個 plugin（jsc-code／jsc-doc／jsc-persona）安裝或更新到一個或多個 AI 助理，可同時處理 Claude Code、Codex、GitHub Copilot CLI、Antigravity 四家原生 plugin CLI 與 OpenCode（複製 skills 目錄）；沒指定時偵測本機裝了哪些 CLI 並讓使用者多選，每個 plugin 先判斷已安裝或未安裝，未安裝就安裝、已安裝就更新到最新，最後以「助理 × plugin」的表格回報結果與版本。當使用者說要安裝所有 jsc plugin、一次更新全部 skill 套件、把 code／doc／persona 都裝起來、要同時更新好幾個 CLI、換新機器要把 plugin 都補齊、或問怎麼一次更新所有 plugin 時觸發。不適用於：移除 plugin（用 /jsc-shared:plugins-uninstall）、只處理單一 plugin（直接照該 plugin README 的安裝章節）、安裝非 JSC 的第三方 plugin。
|
||||
argument-hint: "[--assistant <助理清單，逗號分隔，或 all>] [--plugins code,doc,persona] [--host <gitea 主機>] [--clone-dir <目錄>] [--yes]"
|
||||
---
|
||||
|
||||
@@ -17,19 +17,19 @@ argument-hint: "[--assistant <助理清單，逗號分隔，或 all>] [--plugins
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（generic plugin，必要前置）
|
||||
## 共用規範（shared plugin，必要前置）
|
||||
|
||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守：
|
||||
|
||||
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、表格呈現。
|
||||
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
||||
- `/jsc-generic:spec-git-safety`：Antigravity／OpenCode 路徑會動到本機 clone，**工作區有未提交變更時不得強制更新**。
|
||||
- `/jsc-shared:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、表格呈現。
|
||||
- `/jsc-shared:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
||||
- `/jsc-shared:spec-git-safety`：Antigravity／OpenCode 路徑會動到本機 clone，**工作區有未提交變更時不得強制更新**。
|
||||
|
||||
本 skill 特有補充：
|
||||
|
||||
- **不移除任何東西**。更新時就算需要「先移除再安裝」（Antigravity 沒有 update 子指令），也只針對該 plugin 自己，且移除後必須立刻重裝成功。
|
||||
- **必要決策**（會中斷詢問）：無法判斷目前是哪個助理、指定的助理 CLI 不存在、本機 clone 有未提交變更、安裝失敗且原因需要使用者裁示。
|
||||
- **本 skill 不處理 `jsc-generic` 自己**：它是本 skill 的所在地，安裝它請直接照 generic 的 README。
|
||||
- **本 skill 不處理 `jsc-shared` 自己**：它是本 skill 的所在地，安裝它請直接照 shared 的 README。
|
||||
|
||||
---
|
||||
|
||||
@@ -190,7 +190,7 @@ cp -r <clone-dir>/<repo>/skills/* ~/.config/opencode/skills/
|
||||
|
||||
> **Windows PowerShell**：`cp -r A B` → `Copy-Item A B -Recurse -Force`、`~` → `$HOME`。
|
||||
|
||||
- **`cp -r` 不是覆蓋，是合併**：同名檔案會更新，但**上游已經刪掉的檔案會原地留著**。所以 skill 改名或移除之後，OpenCode 端會同時留著新舊兩份。要乾淨更新就先刪該 plugin 帶入的目錄再複製一次（刪法見 `/jsc-generic:plugins-uninstall` 的 OpenCode 段）。回報時不要講「已覆蓋」，講「已複製，舊檔可能殘留」。
|
||||
- **`cp -r` 不是覆蓋，是合併**：同名檔案會更新，但**上游已經刪掉的檔案會原地留著**。所以 skill 改名或移除之後，OpenCode 端會同時留著新舊兩份。要乾淨更新就先刪該 plugin 帶入的目錄再複製一次（刪法見 `/jsc-shared:plugins-uninstall` 的 OpenCode 段）。回報時不要講「已覆蓋」，講「已複製，舊檔可能殘留」。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user