@@ -59,8 +59,8 @@ shared/
> 指令中的 repo 網址換成你的：`https://gitea.jsc.idv.tw/plugins/shared.git`
>
> **Claude / Codex 從 git URL 安裝（會 clone 遠端），請先把本 repo `push` 到 gitea。**
> **Antigravity 的 `agy plugin install <url>` 目前只支援 github.com**； 改用「clone + 本地路徑」（見 Antigravity 節） 。
> 本機/離線：Claude 可用本地路徑加 marketplace； 。
> **Antigravity 的 `agy plugin install <url>` 目前只支援 github.com**； 依本節改用「從遠端重新抓取到暫存目錄，再用本地路徑安裝」 。
> 本 repo 的安裝／更新／移除流程一律以 Gitea 遠端檔案與下方 README 章節為準，不依賴既有本機存取庫 。
### Claude Code
@@ -79,7 +79,7 @@ claude plugin marketplace remove shared
```
- 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin` 。
- 本機開發（免 push） ： `claude plugin marketplace add C:\Users\h3285\source\repos.plugins\shared` （本地路徑）後再 install 。
- 本機開發（免 push） 仍可用本地路徑，但正式安裝請以 Gitea 遠端 README 為準 。
- **呼叫**： `/jsc-shared:<name>` （例 `/jsc-shared:spec-output` ）。
### Codex
@@ -103,23 +103,24 @@ codex plugin marketplace remove shared
### Antigravity（ ）
> `agy plugin install <url>` 目前**只支援 github.com**； `git clone` 再用**本地路徑**安裝。
> `agy plugin install <url>` 目前**只支援 github.com**； 從遠端抓到暫存目錄， 再用**本地路徑**安裝。
``` bash
# 安裝：clone 後 用本地路徑
git clone https://gitea.jsc.idv.tw/plugins/shared.git ~/plugins/ shared
agy plugin install ~/plugins/ shared
# 安裝：先從遠端抓到暫存目錄，再 用本地路徑
git clone --depth 1 https://gitea.jsc.idv.tw/plugins/shared.git /tmp/jsc- shared
agy plugin install /tmp/jsc- shared
# 更新（agy 無 update 子指令 → git pull 後重裝）
git -C ~/plugins/shared pull
# 更新（重新抓取遠端 後重裝）
git clone --depth 1 https://gitea.jsc.idv.tw/plugins/shared.git /tmp/jsc-shared
agy plugin uninstall jsc-shared
agy plugin install ~/plugins/ shared
agy plugin install /tmp/jsc- shared
# 移除
agy plugin uninstall jsc-shared
```
- 若把 skills 放到 GitHub，則可直接 `agy plugin install https://github.com/<owner>/<repo>` 。
- 不讀取既有本機 repo；若需要對照 README，只用遠端 checkout 的暫存工作區。
- 其他：`agy plugin list` 、`agy plugin enable jsc-shared` / `disable jsc-shared` 、`agy plugin validate <path>` 。安裝後重啟工作階段。
- **呼叫**： `/jsc-shared:<name>` （例 `/jsc-shared:spec-output` ）或依描述自動觸發。
@@ -130,16 +131,16 @@ OpenCode 會讀 `~/.config/opencode/skills/`（也會讀 `~/.claude/skills/`、`
``` bash
# 安裝
git clone https://gitea.jsc.idv.tw/plugins/shared.git ~/plugins/ shared
git clone --depth 1 https://gitea.jsc.idv.tw/plugins/shared.git /tmp/jsc- shared
mkdir -p ~/.config/opencode/skills
cp -r ~/plugins/ shared/skills/* ~/.config/opencode/skills/
cp -r /tmp/jsc- shared/skills/* ~/.config/opencode/skills/
# 更新
git -C ~/plugins/shared pull
cp -r ~/plugins/ shared/skills/* ~/.config/opencode/skills/
git clone --depth 1 https://gitea.jsc.idv.tw/plugins/shared.git /tmp/jsc-shared
cp -r /tmp/jsc- shared/skills/* ~/.config/opencode/skills/
# 移除（逐一移除本 plugin 帶入的 skill 目錄；勿只清 spec-*，否則其他 skill 會殘留）
for s in ~/plugins/ shared/skills/*/; do rm -rf " $HOME /.config/opencode/skills/ $( basename " $s " ) " ; done
for s in /tmp/jsc- shared/skills/*/; do rm -rf " $HOME /.config/opencode/skills/ $( basename " $s " ) " ; done
```
> **Windows PowerShell**：
@@ -219,10 +220,10 @@ copilot plugin marketplace remove shared
| Skill | 用途 | 使用方法 |
| --- | --- | --- |
| `plugins-install` | 一次**安裝或更新** `jsc-code` 、`jsc-doc` 、`jsc-persona` ：先盤點每個 plugin 已安裝或未安裝，未安裝就安裝、已安裝就更新到最新，最後以表格回報動作、結果與版本。Antigravity 走「clone + 本地路徑」，O penC ode 走複製 `skills/` `/jsc-shared:plugins-install` ；可帶 `--assistant claude\|codex\|copilot\|agy\|opencode` 、`--plugins code,doc,persona` 、`--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` 、`--keep-clone` 、 `-- yes`
| `plugins-install` | 一次**安裝或更新** `jsc-code` 、`jsc-doc` 、`jsc-persona` 、 `jsc-shared` `agy` ／ `o penc ode` 先從 Gitea 遠端抓取 README 與技能檔到暫存目錄，再依 README 指示安裝或複製 | `/jsc-shared:plugins-install` ；可帶 `--assistant claude\|codex\|copilot\|agy\|opencode` 、`--plugins code,doc,persona,shared ` 、`--host <gitea 主機>` 、`--temp -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-shared` 自己**（它是這兩個 skill 的所在地）；`plugins-uninstall` 則會，而且放在 最後一步。
> `plugins-install` 與 `plugins-uninstall` 都會處理 `jsc-shared`；移除時一定放 最後一步。
### 角色與記憶
@@ -267,8 +268,8 @@ copilot plugin marketplace remove shared
6. 讓各助理更新：
- Claude： `claude plugin update jsc-shared@shared`
- Codex： `codex plugin marketplace upgrade shared`
- Antigravity： `git -C ~/plugins/shared pull && agy plugin uninstall jsc-shared && agy plugin install ~/plugins/shared` （路徑與上方 Antigravity 安裝節一致）
- OpenCode： `git pull` 後重新 複製 `skills/`
- Antigravity： 重新從 Gitea 遠端抓取到暫存目錄後再 ` agy plugin uninstall jsc-shared && agy plugin install <temp-dir>/shared`
- OpenCode： 重新從 Gitea 遠端抓取到暫存目錄後再 複製 `skills/`
- Copilot： `copilot plugin marketplace update shared && copilot plugin update jsc-shared@shared`
> **skill 帶可執行元件時**（腳本、hook）額外注意：