feat(plugins-install): 非指令助理改為先讀設定就地更新 #38

2026-08-03T04:42:53Z

jiantw83 commented

2026-08-03 04:42:53 +00:00

變更摘要

plugins-install 處理非指令助理（沒有 plugin CLI、靠複製 skills/ 目錄的助理，目前是 OpenCode）時，改為先讀該工具設定判定安裝位置，再決定要更新哪一份。

新流程（階段 C）

步驟	行為
C-1 判位置	由近到遠列候選並只採計磁碟上真的存在的：`<專案根>/.opencode/skills/`（往上找 `opencode.json`／`opencode.jsonc`／`.opencode/` 認專案根）→ `${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/` → `~/.claude/skills`、`~/.agents/skills`
C-2 已安裝	就地更新該位置；明文禁止「順便再往全域目錄倒一份」。多處都命中就全部更新並提醒重複安裝；目標落在 git 專案內時只回報未提交變更，不代為 commit
C-3 未安裝	四處都沒有才 `mkdir -p` 工具全域資料夾再複製；不因當下剛好在某專案就裝進那個專案

設定檔存在但解析失敗一律記為「需人工確認」，不猜；設定指到自訂路徑則以設定為準。

配套

階段 B 判定改為掃過所有候選位置再決定安裝／更新。
階段 D 回報表格新增**「位置」欄**，非指令助理必填實際複製到的絕對路徑。
frontmatter description 補上對應觸發詞。
README 的 plugins-install 說明同步，並修正過時的 --temp-dir（實際參數是 --clone-dir）。
plugins-install／plugins-uninstall 的 code skill 目錄清單補上新增的 target。

影響範圍

檔案	內容
`skills/plugins-install/SKILL.md`	主體改動（+77／-18）
`skills/plugins-uninstall/SKILL.md`	補 `target` skill 目錄
`README.md`	同步說明與參數名
三份 manifest	版號 0.0.4 → 0.0.5

Claude／Codex／Copilot／Antigravity 四家原生 CLI 的流程未變動。

Commit

feat(plugins-install): 非指令助理改為先讀設定就地更新、未安裝才放進工具資料夾
docs(plugins 安裝管理): 同步 README 安裝行為說明並補上 code 的 target skill
chore(plugin 版本): 三家 manifest 升版 0.0.5

## 變更摘要 `plugins-install` 處理**非指令助理**（沒有 plugin CLI、靠複製 `skills/` 目錄的助理，目前是 OpenCode）時，改為先讀該工具設定判定安裝位置，再決定要更新哪一份。 ### 新流程（階段 C） | 步驟 | 行為 | | --- | --- | | C-1 判位置 | 由近到遠列候選並**只採計磁碟上真的存在的**：`<專案根>/.opencode/skills/`（往上找 `opencode.json`／`opencode.jsonc`／`.opencode/` 認專案根）→ `${XDG_CONFIG_HOME:-$HOME/.config}/opencode/skills/` → `~/.claude/skills`、`~/.agents/skills` | | C-2 已安裝 | **就地更新該位置**；明文禁止「順便再往全域目錄倒一份」。多處都命中就全部更新並提醒重複安裝；目標落在 git 專案內時只回報未提交變更，不代為 commit | | C-3 未安裝 | 四處都沒有才 `mkdir -p` 工具全域資料夾再複製；不因當下剛好在某專案就裝進那個專案 | 設定檔存在但解析失敗一律記為「需人工確認」，不猜；設定指到自訂路徑則以設定為準。 ### 配套 - 階段 B 判定改為掃過所有候選位置再決定安裝／更新。 - 階段 D 回報表格新增**「位置」欄**，非指令助理必填實際複製到的絕對路徑。 - frontmatter `description` 補上對應觸發詞。 - README 的 `plugins-install` 說明同步，並修正過時的 `--temp-dir`（實際參數是 `--clone-dir`）。 - `plugins-install`／`plugins-uninstall` 的 code skill 目錄清單補上新增的 `target`。 ## 影響範圍 | 檔案 | 內容 | | --- | --- | | `skills/plugins-install/SKILL.md` | 主體改動（+77／-18） | | `skills/plugins-uninstall/SKILL.md` | 補 `target` skill 目錄 | | `README.md` | 同步說明與參數名 | | 三份 manifest | 版號 0.0.4 → 0.0.5 | Claude／Codex／Copilot／Antigravity 四家原生 CLI 的流程未變動。 ## Commit - `feat(plugins-install): 非指令助理改為先讀設定就地更新、未安裝才放進工具資料夾` - `docs(plugins 安裝管理): 同步 README 安裝行為說明並補上 code 的 target skill` - `chore(plugin 版本): 三家 manifest 升版 0.0.5`

jiantw83 added 4 commits 2026-08-03 04:42:53 +00:00

Merge pull request 'sync' (#37 ) from master into develop 37022854b8

Reviewed-on: #37

feat(plugins-install): 非指令助理改為先讀設定就地更新、未安裝才放進工具資料夾 d2ffbdae17

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs(plugins 安裝管理): 同步 README 安裝行為說明並補上 code 的 target skill 815f34377b

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

chore(plugin 版本): 三家 manifest 升版 0.0.5 3dccddf055

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

admin approved these changes 2026-08-03 05:34:04 +00:00

admin merged commit e17589ad04 into master

2026-08-03 05:34:06 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/shared#38