docs(plugins 安裝管理): 統一無 plugin 匯入指令工具流程

This commit is contained in:
2026-08-03 06:17:11 +00:00
parent 3dccddf055
commit 0d3bd72de3
4 changed files with 27 additions and 22 deletions
+11 -6
View File
@@ -14,7 +14,7 @@
| Claude Code | `claude plugin`marketplace | `/jsc-shared:<name>` 或自動觸發 | ✅ |
| Codex | `codex plugin`marketplace | `$<name>``/skills` 選單 | ❌(用 `$name` |
| Antigravity | `agy plugin install` | `/jsc-shared:<name>` 或自動觸發 | ✅ |
| OpenCode | skills 目錄(複製/clone) | 描述需求自動觸發 | ❌(依名稱) |
| OpenCode | skills 目錄(clone 到工具專屬資料夾,再依 README 匯入) | 描述需求自動觸發 | ❌(依名稱) |
| GitHub Copilot CLI | `copilot plugin`marketplace | 自然語言或 plugin skills | ❌(無 `/jsc-shared:` 前綴) |
> Codex 不支援自訂前綴(skill 以 `$name` 呼叫);OpenCode 由模型依描述自動呼叫;Copilot CLI 透過原生 plugin 安裝後以自然語言或 plugin skills 使用。三者皆**不強制**前綴。
@@ -118,10 +118,15 @@ agy plugin uninstall jsc-shared
- 其他:`agy plugin list``agy plugin enable jsc-shared` / `disable jsc-shared``agy plugin validate <path>`。安裝後重啟工作階段。
- **呼叫**`/jsc-shared:<name>`(例 `/jsc-shared:spec-output`)或依描述自動觸發。
### OpenCode
### 無 plugin 指令但可使用 skill 的助理
OpenCode 的「plugin」是 TypeScript/npm 套件,不適用於 skill 包;skills 改用**目錄安裝**。
OpenCode 會讀 `~/.config/opencode/skills/`(也會讀 `~/.claude/skills/``~/.agents/skills/`)。
OpenCode 為例,這類工具不走原生 plugin install / uninstall,而是:
1. 先把整組 skill clone 到工具的專屬資料夾。
2. 再依技能組自己的 `README.md`,把技能匯入到 README 指定的位置。
3. 移除時則反向刪除 README 指定的那些 skill 目錄。
OpenCode 會讀 `~/.config/opencode/skills/`(也會讀 `~/.claude/skills/``~/.agents/skills/`),因此可把技能匯入這些位置。
```bash
# 安裝
@@ -214,8 +219,8 @@ copilot plugin marketplace remove shared
| Skill | 用途 | 使用方法 |
| --- | --- | --- |
| `plugins-install` | 一次**安裝或更新** `jsc-code``jsc-doc``jsc-persona``jsc-shared`:先盤點每個 plugin 已安裝或未安裝,未安裝就安裝、已安裝就更新到最新,最後以表格回報動作、位置、結果與版本。`agy` 走 clone+本地路徑安裝;`opencode` 這類**沒有 plugin 指令**的助理先讀該工具設定找出 skills 實際掛載路徑(可能是某個專案下的 `.opencode/skills`,**已安裝就在該路徑就地更新、未安裝才放進工具的全域資料夾** | `/jsc-shared:plugins-install`;可帶 `--assistant claude\|codex\|copilot\|agy\|opencode``--plugins code,doc,persona,shared``--host <gitea 主機>``--clone-dir <目錄>``--yes` |
| `plugins-uninstall` | 一次**移除** `jsc-code``jsc-doc``jsc-persona``jsc-shared`:動手前先列出將被移除的項目與不會被碰的資料請使用者確認,移除順序固定把 `jsc-shared` 放最後(本 skill 就住在裡面)。人格倉庫與記憶目錄一律不刪 | `/jsc-shared:plugins-uninstall`;可帶 `--assistant …``--plugins code,doc,persona,shared``--keep-marketplace``--yes` |
| `plugins-install` | 一次**安裝或更新** `jsc-code``jsc-doc``jsc-persona``jsc-shared`:先盤點每個 plugin 已安裝或未安裝,未安裝就安裝、已安裝就更新到最新,最後以表格回報動作、位置、結果與版本。`agy` 走 clone+本地路徑安裝;OpenCode 這類**沒有 plugin 匯入指令、但可使用 skill** 的助理先把技能組 clone 到工具專屬資料夾,再依技能組 `README.md` 匯入到指定位置,**已安裝就在該路徑就地更新、未安裝才放進工具的全域資料夾** | `/jsc-shared:plugins-install`;可帶 `--assistant claude\|codex\|copilot\|agy\|opencode``--plugins code,doc,persona,shared``--host <gitea 主機>``--clone-dir <目錄>``--yes` |
| `plugins-uninstall` | 一次**移除** `jsc-code``jsc-doc``jsc-persona``jsc-shared`:動手前先列出將被移除的項目與不會被碰的資料請使用者確認,移除順序固定把 `jsc-shared` 放最後(本 skill 就住在裡面)。人格倉庫與記憶目錄一律不刪OpenCode 這類**沒有 plugin 匯入指令、但可使用 skill** 的助理則依技能組 `README.md` 反向刪除匯入位置 | `/jsc-shared:plugins-uninstall`;可帶 `--assistant …``--plugins code,doc,persona,shared``--keep-marketplace``--yes` |
> `plugins-install` 與 `plugins-uninstall` 都會處理 `jsc-shared`;移除時一定放最後一步。