From dc1705a449872ffb0df85eb2d6c23ffd6daf234a Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 13:47:12 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(README):=20=E4=BF=AE=E6=AD=A3=E6=AE=98?= =?UTF-8?q?=E7=95=99=E7=9A=84=20template=20=E5=80=BC=E7=82=BA=20generic=20?= =?UTF-8?q?=E5=B0=88=E5=B1=AC=E8=A8=AD=E5=AE=9A=EF=BC=88repo=20=E7=B6=B2?= =?UTF-8?q?=E5=9D=80=EF=BC=8F=E8=B7=AF=E5=BE=91=EF=BC=8F=E7=9B=AE=E9=8C=84?= =?UTF-8?q?=E6=A8=B9=EF=BC=8Fmarketplace=20=E5=90=8D=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 48 ++++++++++++++++++++++++------------------------ 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 70d58b5..3465782 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ 同一個 repo 同時帶四種 manifest，彼此以路徑隔離、互不干擾；四家都讀同一份 `skills/`。 ``` -template/ +generic/ ├── .claude-plugin/ │ ├── plugin.json # Claude 外掛定義（name: "jsc"） │ └── marketplace.json # Claude marketplace（name: "jsc-plugins"，source 指向本 repo） @@ -44,7 +44,7 @@ template/ ## 安裝 / 更新 / 移除（各家原生 plugin CLI） -> 指令中的 repo 網址換成你的：`https://gitea.jsc.idv.tw/plugins/template.git` +> 指令中的 repo 網址換成你的：`https://gitea.jsc.idv.tw/plugins/generic.git` > > **Claude / Codex 從 git URL 安裝（會 clone 遠端），請先把本 repo `push` 到 gitea。** > **Antigravity 的 `agy plugin install ` 目前只支援 github.com**；gitea 請改用「clone + 本地路徑」（見 Antigravity 節）。 @@ -54,38 +54,38 @@ template/ ```bash # 安裝 -claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/template.git -claude plugin install jsc@template +claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/generic.git +claude plugin install jsc@jsc-plugins # 更新 -claude plugin marketplace update template -claude plugin update jsc@template +claude plugin marketplace update jsc-plugins +claude plugin update jsc@jsc-plugins # 移除 -claude plugin uninstall jsc@template -claude plugin marketplace remove template +claude plugin uninstall jsc@jsc-plugins +claude plugin marketplace remove jsc-plugins ``` - 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。 -- 本機開發（免 push）：`claude plugin marketplace add C:\Users\h3285\source\repos.plugins\template`（本地路徑）後再 install。 +- 本機開發（免 push）：`claude plugin marketplace add C:\Users\h3285\source\repos.plugins\generic`（本地路徑）後再 install。 - **呼叫**：`/jsc:`（例 `/jsc:spec-output`）。 ### Codex ```bash # 安裝 -codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/template.git -codex plugin add jsc@template +codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/generic.git +codex plugin add jsc@jsc-plugins # 更新（重新抓取 marketplace 的 git 快照） -codex plugin marketplace upgrade template +codex plugin marketplace upgrade jsc-plugins # 移除 -codex plugin remove jsc@template -codex plugin marketplace remove template +codex plugin remove jsc@jsc-plugins +codex plugin marketplace remove jsc-plugins ``` -- 安裝 token `jsc@template` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。 +- 安裝 token `jsc@jsc-plugins` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。 - 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。 - **呼叫**：`$`（例 `$spec-output`），或用 `/skills` 選單。 @@ -95,13 +95,13 @@ codex plugin marketplace remove template ```bash # 安裝：clone 後用本地路徑 -git clone https://gitea.jsc.idv.tw/plugins/template.git ~/plugins/template -agy plugin install ~/plugins/template +git clone https://gitea.jsc.idv.tw/plugins/generic.git ~/plugins/generic +agy plugin install ~/plugins/generic # 更新（agy 無 update 子指令 → git pull 後重裝） -git -C ~/plugins/template pull +git -C ~/plugins/generic pull agy plugin uninstall jsc -agy plugin install ~/plugins/template +agy plugin install ~/plugins/generic # 移除 agy plugin uninstall jsc @@ -118,13 +118,13 @@ OpenCode 會讀 `~/.config/opencode/skills/`（也會讀 `~/.claude/skills/`、` ```bash # 安裝 -git clone https://gitea.jsc.idv.tw/plugins/template.git ~/plugins/template +git clone https://gitea.jsc.idv.tw/plugins/generic.git ~/plugins/generic mkdir -p ~/.config/opencode/skills -cp -r ~/plugins/template/skills/* ~/.config/opencode/skills/ +cp -r ~/plugins/generic/skills/* ~/.config/opencode/skills/ # 更新 -git -C ~/plugins/template pull -cp -r ~/plugins/template/skills/* ~/.config/opencode/skills/ +git -C ~/plugins/generic pull +cp -r ~/plugins/generic/skills/* ~/.config/opencode/skills/ # 移除 rm -rf ~/.config/opencode/skills/spec-* @@ -184,7 +184,7 @@ rm -rf ~/.config/opencode/skills/spec-* ## 新增一個 skill -1. 複製範本：`cp -r skills/spec-output skills/`（或從 template repo 的 `skills/hello` 複製） +1. 複製既有 skill 作範本：`cp -r skills/spec-output skills/` 2. 編輯 `skills//SKILL.md` 的 frontmatter： - `name`：小寫、數字、連字號（`-`），最長 64 字元。**這就是 Claude Code / Antigravity 的 `/jsc:`**。 - `description`：第三人稱，寫清楚「何時用、何時不用」與觸發關鍵字 — 這是各助理自動載入的唯一依據。 -- 2.53.0 From a2b0a51a353b8a5a7dfedc9b8108ce7db449b2c0 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 13:57:33 +0800 Subject: [PATCH 2/2] =?UTF-8?q?chore(marketplace):=20=E5=B0=87=20marketpla?= =?UTF-8?q?ce=20=E5=90=8D=E7=94=B1=20jsc-plugins=20=E6=94=B9=E7=82=BA=20ge?= =?UTF-8?q?neric=20=E4=B8=A6=E5=90=8C=E6=AD=A5=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/plugins/marketplace.json | 2 +- .claude-plugin/marketplace.json | 2 +- README.md | 28 ++++++++++++++-------------- 3 files changed, 16 insertions(+), 16 deletions(-) diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index fd081fa..5501b95 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -1,5 +1,5 @@ { - "name": "jsc-plugins", + "name": "generic", "plugins": [ { "name": "jsc", diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 899e2e8..b898c72 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,5 +1,5 @@ { - "name": "jsc-plugins", + "name": "generic", "description": "JSC 跨 AI 助理共用 skills 的 Claude Code marketplace。", "owner": { "name": "JSC" diff --git a/README.md b/README.md index 3465782..92f38e2 100644 --- a/README.md +++ b/README.md @@ -28,11 +28,11 @@ generic/ ├── .claude-plugin/ │ ├── plugin.json # Claude 外掛定義（name: "jsc"） -│ └── marketplace.json # Claude marketplace（name: "jsc-plugins"，source 指向本 repo） +│ └── marketplace.json # Claude marketplace（name: "generic"，source 指向本 repo） ├── .codex-plugin/ │ └── plugin.json # Codex 外掛定義（name: "jsc"，skills: "./skills"） ├── .agents/plugins/ -│ └── marketplace.json # Codex marketplace（name: "jsc-plugins"，url source 指向本 repo） +│ └── marketplace.json # Codex marketplace（name: "generic"，url source 指向本 repo） ├── plugin.json # Antigravity 外掛定義（name: "jsc"，skills: "./skills/"） ├── skills/ # ★ 唯一真實來源：所有 skills │ └── spec-*/SKILL.md # 共用規範 skills（一規範一目錄） @@ -55,15 +55,15 @@ generic/ ```bash # 安裝 claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/generic.git -claude plugin install jsc@jsc-plugins +claude plugin install jsc@generic # 更新 -claude plugin marketplace update jsc-plugins -claude plugin update jsc@jsc-plugins +claude plugin marketplace update generic +claude plugin update jsc@generic # 移除 -claude plugin uninstall jsc@jsc-plugins -claude plugin marketplace remove jsc-plugins +claude plugin uninstall jsc@generic +claude plugin marketplace remove generic ``` - 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。 @@ -75,17 +75,17 @@ claude plugin marketplace remove jsc-plugins ```bash # 安裝 codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/generic.git -codex plugin add jsc@jsc-plugins +codex plugin add jsc@generic # 更新（重新抓取 marketplace 的 git 快照） -codex plugin marketplace upgrade jsc-plugins +codex plugin marketplace upgrade generic # 移除 -codex plugin remove jsc@jsc-plugins -codex plugin marketplace remove jsc-plugins +codex plugin remove jsc@generic +codex plugin marketplace remove generic ``` -- 安裝 token `jsc@jsc-plugins` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。 +- 安裝 token `jsc@generic` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。 - 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。 - **呼叫**：`$`（例 `$spec-output`），或用 `/skills` 選單。 @@ -192,7 +192,7 @@ rm -rf ~/.config/opencode/skills/spec-* 4. 手動把這個 skill 補進上方「Skills 目錄」區塊。 5. **bump 版本並 push**：四家都以 git 內容/版本判斷更新，請把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 三個 manifest 的 `version` 一起 bump（規則見 `skills/spec-plugin-version/`），commit 後 push 到 gitea。 6. 讓各助理更新： - - Claude：`claude plugin update jsc@jsc-plugins` - - Codex：`codex plugin marketplace upgrade jsc-plugins` + - Claude：`claude plugin update jsc@generic` + - Codex：`codex plugin marketplace upgrade generic` - Antigravity：`git -C ~/jsc-plugin pull && agy plugin uninstall jsc && agy plugin install ~/jsc-plugin` - OpenCode：`git pull` 後重新複製 `skills/` -- 2.53.0