feat(skills): 兩個 skill 都改成可一次處理多個 CLI，並修掉闇影劍找到的問題
一次處理多個助理（使用者要求）： - `--assistant` 從單一值改成清單，支援 `claude,codex,copilot` 與 `all`。 - 沒帶參數時偵測本機有哪些 CLI：只有一個就直接用，多個就讓使用者多選 （安裝預設全選；移除是不可逆的，預設不全選）。 - 盤點與執行的迴圈改成「助理 × plugin」，回報表格加上「助理」欄。 - 正在執行本 skill 的那個助理排到最後處理——更新它要重啟工作階段， 而移除它自己的 jsc-generic 之後，後面的助理就處理不到了。 闇影劍審 PR #30 找到的問題： - Antigravity 與 OpenCode 的安裝分支無條件 `git clone`，clone 目錄已存在時 會 fatal 中止（開發者自己就 clone 在預設的 ~/plugins）。改成先判斷 `.git` 存在與否，已存在就 `pull --ff-only`。 - 新增「先確認 clone 在哪個分支」：預設路徑很可能是開發者的工作區， 停在 develop 時裝進去的是未合併內容，要先告知使用者。 - OpenCode 的移除指令用 `{a,b,c}` brace expansion，有三種會靜默失效的情況 （逗號後有空格、單一元素、dash/sh 不支援），全都是「什麼都沒刪但結束碼 0」。 改成從本機 clone 的 skills/ 推導清單跑迴圈，退路是一行一個 rm。 - 硬編碼的 skill 目錄清單只是快照，plugin 新增 skill 後會殘留。改為優先從 clone 推導，用表時要註明「清單可能不完整」。 - `cp -r` 不是覆蓋是合併，上游刪掉的檔案會留著。移除「覆蓋複製」這個 不成立的說法。 - 階段 D 的版本欄只有 Antigravity 與 OpenCode 拿得到，其餘三家寫「未知」。 依 spec-plugin-version 升版 0.1.7（master 現行 0.1.6）。
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
---
|
||||
name: plugins-uninstall
|
||||
description: 一次把 JSC 的四個 plugin（jsc-code／jsc-doc／jsc-persona／jsc-generic）從目前的 AI 助理移除，支援 Claude Code、Codex、GitHub Copilot CLI、Antigravity 四家原生 plugin CLI，OpenCode 則刪除先前複製進去的 skill 目錄；移除順序固定把 jsc-generic 放到最後（本 skill 就住在裡面，移除後即失效），並在動手前列出將被移除的項目與會受影響的本機資料讓使用者確認。當使用者說要移除所有 jsc plugin、把 skill 套件整組解除安裝、清掉 code／doc／persona／generic、重灌前先卸載、或問怎麼一次移除全部 plugin 時觸發。不適用於：安裝或更新（用 /jsc-generic:plugins-install）、只移除單一 plugin（直接照該 plugin README 的移除章節）、刪除人格資料或 Gitea 上的存取庫。
|
||||
argument-hint: "[--assistant claude|codex|copilot|agy|opencode] [--plugins code,doc,persona,generic] [--keep-marketplace] [--keep-clone] [--yes]"
|
||||
description: 一次把 JSC 的四個 plugin（jsc-code／jsc-doc／jsc-persona／jsc-generic）從一個或多個 AI 助理移除，可同時處理 Claude Code、Codex、GitHub Copilot CLI、Antigravity 四家原生 plugin CLI 與 OpenCode（刪除先前複製進去的 skill 目錄）；沒指定時偵測本機裝了哪些 CLI 並讓使用者多選；移除順序固定把 jsc-generic 放到最後（本 skill 就住在裡面，移除後即失效），並在動手前列出將被移除的項目與會受影響的本機資料讓使用者確認。當使用者說要移除所有 jsc plugin、把 skill 套件整組解除安裝、清掉 code／doc／persona／generic、重灌前先卸載、要同時從好幾個 CLI 移除、或問怎麼一次移除全部 plugin 時觸發。不適用於：安裝或更新（用 /jsc-generic:plugins-install）、只移除單一 plugin（直接照該 plugin README 的移除章節）、刪除人格資料或 Gitea 上的存取庫。
|
||||
argument-hint: "[--assistant <助理清單，逗號分隔，或 all>] [--plugins code,doc,persona,generic] [--keep-marketplace] [--keep-clone] [--yes]"
|
||||
---
|
||||
|
||||
# plugins-uninstall — 一次移除所有 JSC plugin
|
||||
@@ -10,7 +10,7 @@ argument-hint: "[--assistant claude|codex|copilot|agy|opencode] [--plugins code,
|
||||
|
||||
| 階段 | 動作 |
|
||||
| --- | --- |
|
||||
| A. 前置設定 | 決定要操作哪個助理（`--assistant`／偵測目前執行環境／詢問）→ 決定 plugin 清單（預設四個全移） |
|
||||
| A. 前置設定 | 決定要操作哪些助理（`--assistant` 可帶多個或 all／偵測本機有哪些 CLI／多個就讓使用者多選）→ 決定 plugin 清單（預設四個全移） |
|
||||
| B. 盤點與確認 | 列出實際已安裝的項目、會一併移除的 marketplace 與本機 clone、以及**不會**被碰的資料，請使用者確認 |
|
||||
| C. 移除 | 依 `code` → `doc` → `persona` → `generic` 的順序逐一移除 |
|
||||
| D. 回報 | 表格回報每個 plugin 的結果，並列出刻意保留的殘留物 |
|
||||
@@ -30,12 +30,13 @@ argument-hint: "[--assistant claude|codex|copilot|agy|opencode] [--plugins code,
|
||||
- **移除是不可逆的動作**：階段 B 的確認是**必要決策**，除非帶 `--yes`，否則一定要問過才動手。
|
||||
- **絕不刪除使用者資料**：`~/.claude/personas/`（人格倉庫）、`~/.roles/`、`~/.memory/`（角色與記憶）一律不動，Gitea 上的存取庫也不動。要清這些請使用者自己來。
|
||||
- **順序不可調換**：`jsc-generic` 一定最後移除。它是本 skill 的所在地，移除後本 skill 隨之失效，後面的步驟會執行不到。
|
||||
- **多個助理時的順序**：外層先跑完一個助理的四個 plugin，再換下一個助理。**目前正在執行本 skill 的那個助理排到最後**——不然它自己的 `jsc-generic` 一沒，剩下的助理就處理不到了。
|
||||
|
||||
---
|
||||
|
||||
## 參數
|
||||
|
||||
- `--assistant claude|codex|copilot|agy|opencode`：指定要操作的助理。**省略時**依階段 A1 判斷。
|
||||
- `--assistant <清單>`：要操作的助理，**可以多個**，以逗號分隔（`claude,codex,copilot,agy,opencode`），或用 `all` 代表本機找得到的全部。**省略時**依階段 A1 判斷（只有一個就直接用，多個就讓使用者多選，且不預設全選）。
|
||||
- `--plugins code,doc,persona,generic`：要移除的 plugin（以逗號分隔，用 repo 短名）。**省略時預設四個全移**。
|
||||
- `--keep-marketplace`：只移除 plugin，保留 marketplace 登錄（之後要重裝比較快）。
|
||||
- `--keep-clone`：保留 Antigravity／OpenCode 用的本機 clone 目錄（**預設就是保留**，此旗標僅用於明示）。要刪除本機 clone 必須由使用者在階段 B 明確同意。
|
||||
@@ -63,20 +64,27 @@ argument-hint: "[--assistant claude|codex|copilot|agy|opencode] [--plugins code,
|
||||
| `persona` | `persona-anime`、`persona-chat`、`persona-create`、`persona-icon`、`persona-invite`、`persona-memory`、`persona-relation`、`persona-sleep`、`persona-status`、`persona-sync`、`persona-therapist`、`persona-transfer` |
|
||||
| `generic` | `role`、`plugins-install`、`plugins-uninstall`、`spec-action-params`、`spec-doc-funcs-handoff`、`spec-dockerfile`、`spec-execution`、`spec-gitea`、`spec-git-safety`、`spec-output`、`spec-plugin-version`、`spec-project-board`、`spec-time-log` |
|
||||
|
||||
> OpenCode 是**逐一刪除上表的 skill 目錄**，不可用萬用字元一次掃掉整個 `skills/`——那裡可能還有別處裝進去的 skill。
|
||||
> 上表是**寫下來當天的快照**，plugin 之後新增 skill 它不會自己更新。所以 OpenCode 的刪除**優先從本機 clone 的 `skills/` 推導清單**（見階段 C 的 OpenCode 段），clone 不在時才退回這張表，並在回報裡註明「清單可能不完整」。
|
||||
> 兩種做法都**不可用萬用字元一次掃掉整個 `skills/`**——那裡可能還有別處裝進去的 skill。
|
||||
|
||||
---
|
||||
|
||||
## 階段 A：前置設定
|
||||
|
||||
### A1. 決定助理
|
||||
### A1. 決定助理（可以一次多個）
|
||||
|
||||
`--assistant` 收的是**清單**，不是單一值：`--assistant claude,codex,copilot`、或 `--assistant all`。
|
||||
最終得到的是一組助理，階段 B 到 D 都對**這組的每一個**各跑一遍。
|
||||
|
||||
依序判斷，**第一個成立的就採用**：
|
||||
|
||||
1. 有帶 `--assistant` → 直接採用。
|
||||
2. 目前正在執行本 skill 的助理可自我辨識 → 採用自己。
|
||||
3. 逐一檢查哪些 CLI 存在（`command -v claude codex copilot agy opencode`）→ 只有一個就採用；**有多個就列出來問使用者**。
|
||||
4. 一個都沒有 → 回報「找不到任何支援的助理 CLI」並停止。
|
||||
1. 有帶 `--assistant` → 照它。`all` 代表「本機找得到的全部」（等同下面第 2 點的偵測結果）。
|
||||
2. 沒帶 → 逐一檢查哪些 CLI 存在（`command -v claude codex copilot agy opencode`）：
|
||||
- 找到 **1 個** → 直接用它。
|
||||
- 找到 **多個** → 列出來讓使用者**多選**（移除是不可逆的，**預設不全選**，要他自己勾）。
|
||||
3. 一個都沒有 → 回報「找不到任何支援的助理 CLI」並停止。
|
||||
|
||||
> 目前正在執行本 skill 的那個助理，如果也在清單裡，**放到最後處理**——移掉它自己之後，本 skill 就不存在了。
|
||||
|
||||
### A2. 決定 plugin 清單
|
||||
|
||||
@@ -135,12 +143,25 @@ agy plugin uninstall <plugin>
|
||||
|
||||
### OpenCode
|
||||
|
||||
逐一刪除該 plugin 帶入的 skill 目錄（照上表，不用萬用字元）：
|
||||
逐一刪除該 plugin 帶入的 skill 目錄。**最可靠的做法是從本機 clone 推導清單**，而不是照抄上表——上表是快照，plugin 新增 skill 之後就會漏：
|
||||
|
||||
```bash
|
||||
rm -rf ~/.config/opencode/skills/{<該 plugin 的 skill 目錄，以逗號分隔>}
|
||||
# clone 還在：從來源目錄推導要刪哪些（唯一不會漏的做法）
|
||||
for s in <clone-dir>/<repo>/skills/*/; do
|
||||
rm -rf "$HOME/.config/opencode/skills/$(basename "$s")"
|
||||
done
|
||||
```
|
||||
|
||||
clone 已經不在時才退回上表，且**一個一行分開刪**：
|
||||
|
||||
```bash
|
||||
rm -rf ~/.config/opencode/skills/docker
|
||||
rm -rf ~/.config/opencode/skills/funcs
|
||||
# …照上表逐行
|
||||
```
|
||||
|
||||
> **不要用 `{a,b,c}` 這種 brace expansion**。它有三種會靜默失效的情況：逗號後有空格（`{a, b}`）不展開、只有一個元素（`{a}`）不展開、以及在 `dash`／`sh` 底下完全不支援。三種都是「什麼都沒刪，但 `-f` 讓結束碼還是 0」，回報會變成假的 ✅。
|
||||
|
||||
> **Windows PowerShell**：`rm -rf X` → `Remove-Item X -Recurse -Force`、`~` → `$HOME`。
|
||||
|
||||
### `jsc-generic` 的收尾
|
||||
@@ -155,11 +176,14 @@ rm -rf ~/.config/opencode/skills/{<該 plugin 的 skill 目錄，以逗號分隔
|
||||
|
||||
## 階段 D：回報
|
||||
|
||||
以表格回報，一個 plugin 一列：
|
||||
以表格回報，**一個「助理 × plugin」一列**：
|
||||
|
||||
| plugin | 動作 | 結果 | 備註 |
|
||||
| --- | --- | --- | --- |
|
||||
| `jsc-code` | 移除／跳過（未安裝） | ✅ 成功／⚠ 需處理／❌ 失敗 | 例：marketplace 已保留 |
|
||||
| 助理 | plugin | 動作 | 結果 | 備註 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| Claude Code | `jsc-code` | 移除／跳過（未安裝） | ✅ 成功／⚠ 需處理／❌ 失敗 | 例：marketplace 已保留 |
|
||||
| Codex | `jsc-code` | 跳過（未安裝） | ✅ | — |
|
||||
|
||||
只處理一個助理時可以省掉「助理」欄。**處理多個時一定要有**，否則使用者看不出哪一格出問題。
|
||||
|
||||
表格下方固定列出：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user