From 9d0c0ba154b2c1b1fdd1a8a025c97b5613efa285 Mon Sep 17 00:00:00 2001 From: root Date: Wed, 14 Oct 2026 02:48:13 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E6=94=B9=E7=82=BA=E7=B5=B1?= =?UTF-8?q?=E4=B8=80=E6=A0=BC=E5=BC=8F=EF=BC=8C=E5=90=84=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=8D=A8=E7=AB=8B=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 5.5 --- README.md | 61 ++++++++++++------------ plugins/jsc-claude/README.md | 44 ++++++++++++++++++ plugins/jsc-companion/README.md | 55 ++++++++++++++++++++++ plugins/jsc-herdr/README.md | 45 ++++++++++++++++++ plugins/jsc-matt/README.md | 82 +++++++++++++++++++++++++++++++++ plugins/jsc-statusbar/README.md | 48 +++++++++++++++++++ 6 files changed, 303 insertions(+), 32 deletions(-) create mode 100644 plugins/jsc-claude/README.md create mode 100644 plugins/jsc-companion/README.md create mode 100644 plugins/jsc-herdr/README.md create mode 100644 plugins/jsc-matt/README.md create mode 100644 plugins/jsc-statusbar/README.md diff --git a/README.md b/README.md index fd7132b..5205a44 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,36 @@ +

jsc-marketplace

+ # jsc-marketplace -JSC 自用 Claude Code mods。每個 mod 皆可單獨安裝、更新與移除。 +JSC 自用 Claude Code mods 的 marketplace。每個插件皆可單獨安裝、更新與移除。 -| Mod | 版本 | 說明 | -| --- | --- | --- | -| [jsc-statusbar](plugins/jsc-statusbar) | 0.0.4 | 輸入框上方單行狀態列：模型、目錄、分支、5h/7d 額度與重置、context、CPU/記憶體/磁碟 | -| [jsc-companion](plugins/jsc-companion) | 0.0.3 | 小說角色陪伴：人設注入、語氣、心情與好感、互動記憶、主動關心與待辦，並可用 ingest skill 解析小說建立角色 | -| [jsc-herdr](plugins/jsc-herdr) | 0.0.3 | 控制 Herdr 終端多工器的技能（workspace、tab、pane、指令與其他 agent；另含 gitea-issue 技能，逐一實作 Gitea 議題，需 Herdr 與 tea） | -| [jsc-claude](plugins/jsc-claude) | 0.0.1 | 用最簡單的方式解釋任何主題：大圖少字的 HTML 圖解（改編自 claude-community 的 eli5） | -| [jsc-matt](plugins/jsc-matt) | 0.0.1 | Matt Pocock 的工程技能整套：grilling、spec/ticket、TDD、code review、領域建模等（改編自 mattpocock/skills，MIT） | +## 插件 + +### [jsc-statusbar](plugins/jsc-statusbar) `0.0.4` + +輸入框上方單行狀態列：模型、目錄、分支、5h/7d 額度與重置、context、CPU/記憶體/磁碟。 + +### [jsc-companion](plugins/jsc-companion) `0.0.3` + +小說角色陪伴：人設注入、語氣、心情與好感、互動記憶、主動關心與待辦，並可用 ingest skill 解析小說建立角色。 + +### [jsc-herdr](plugins/jsc-herdr) `0.0.3` + +控制 Herdr 終端多工器（workspace、tab、pane、指令與其他 agent），並可透過 gitea-issue 技能逐一實作 Gitea 議題。需安裝 Herdr 與 tea。 + +### [jsc-claude](plugins/jsc-claude) `0.0.1` + +用最簡單的方式解釋任何主題：大圖少字的 HTML 圖解（改編自 claude-community 的 eli5）。 + +### [jsc-matt](plugins/jsc-matt) `0.0.1` + +Matt Pocock 的工程技能整套（grilling、spec/ticket、TDD、code review、領域建模等），改編自 mattpocock/skills。 + +各插件的指令與可複製的程式碼片段請見其資料夾內的 README。 ## 安裝 -先加入 marketplace，再依需要安裝個別 mod： +先加入 marketplace，再依需要安裝個別插件： ```bash claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git @@ -23,15 +41,6 @@ claude plugin install jsc-claude@jsc-marketplace claude plugin install jsc-matt@jsc-marketplace ``` -## 指令 - -- `/statusbar on | off | compact`：切換狀態列 -- `/companion status | switch <角色> | off | setup | todo | quiet`：角色陪伴控制（`todo add <內容> [due=YYYY-MM-DDTHH:MM]`、`todo done <編號>`、`quiet [分鐘]`） -- `herdr` skill：提到 Herdr 時自動用於操作 pane、tab、workspace 與其他 agent -- `/jsc-herdr:gitea-issue <議題連結>`：交給 Herdr 裡的 Claude agent 實作 Gitea 議題 -- `/jsc-claude:eli5 <主題>`：用大圖少字的 HTML 圖解簡單解釋主題 -- `/jsc-matt:*`：Matt Pocock 技能整套，如 `/jsc-matt:ask-matt`、`/jsc-matt:grill-with-docs`、`/jsc-matt:to-spec`、`/jsc-matt:to-tickets`、`/jsc-matt:implement`、`/jsc-matt:tdd`、`/jsc-matt:code-review`、`/jsc-matt:diagnosing-bugs`；首次使用請先跑 `/jsc-matt:setup-matt-pocock-skills`。若已安裝官方 `mattpocock-skills`，建議移除以免重複 - ## 更新 ```bash @@ -56,20 +65,8 @@ claude plugin uninstall jsc-matt@jsc-marketplace claude plugin marketplace remove jsc-marketplace ``` +曾安裝舊名稱（`statusbar`、`companion`、`herdr`、`herdr-issue`、`jsc-eli5`）的環境，請先 `claude plugin uninstall <舊名>@jsc-marketplace` 再安裝新名稱。`jsc-eli5` 已改名為 `jsc-claude`，指令為 `/jsc-claude:eli5`。 + ## 授權 [MIT License](LICENSE) - -## 移除舊版 - -外掛已改名加上 `jsc-` 前綴，`herdr-issue` 也已併入 `jsc-herdr`（改名為 `gitea-issue`，指令為 `/jsc-herdr:gitea-issue`）。曾安裝舊版的環境請先移除舊名稱，再安裝新名稱： - -```bash -claude plugin uninstall statusbar@jsc-marketplace -claude plugin uninstall companion@jsc-marketplace -claude plugin uninstall herdr@jsc-marketplace -claude plugin uninstall herdr-issue@jsc-marketplace -claude plugin uninstall jsc-eli5@jsc-marketplace -``` - -`jsc-eli5` 已改名為 `jsc-claude`，指令由 `/jsc-eli5:eli5` 改為 `/jsc-claude:eli5`。 diff --git a/plugins/jsc-claude/README.md b/plugins/jsc-claude/README.md new file mode 100644 index 0000000..e2e29a7 --- /dev/null +++ b/plugins/jsc-claude/README.md @@ -0,0 +1,44 @@ +

jsc-claude

+ +# jsc-claude + +用最簡單的方式解釋任何主題：大圖少字的 HTML 圖解（改編自 claude-community 的 eli5）。 + +目前版本：0.0.1 + +## 指令 + +| 指令 | 說明 | +| --- | --- | +| `/jsc-claude:eli5 <主題>` | 以大圖少字的 HTML 圖解簡單解釋主題 | + +```text +/jsc-claude:eli5 區塊鏈 +``` + + +## 安裝 + +```bash +claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git +claude plugin install jsc-claude@jsc-marketplace +``` + +## 更新 + +```bash +claude plugin marketplace update jsc-marketplace +claude plugin update jsc-claude@jsc-marketplace +``` + +更新後需重新啟動 Claude Code 才會生效。 + +## 移除 + +```bash +claude plugin uninstall jsc-claude@jsc-marketplace +``` + +## 授權 + +[MIT License](../../LICENSE) diff --git a/plugins/jsc-companion/README.md b/plugins/jsc-companion/README.md new file mode 100644 index 0000000..4da5429 --- /dev/null +++ b/plugins/jsc-companion/README.md @@ -0,0 +1,55 @@ +

jsc-companion

+ +# jsc-companion + +小說角色陪伴：人設注入、語氣、心情與好感、互動記憶、主動關心與待辦，並可用 ingest skill 解析小說建立角色。 + +目前版本：0.0.3 + +## 指令 + +| 指令 | 說明 | +| --- | --- | +| `/companion status` | 查看目前角色與狀態 | +| `/companion switch <角色>` | 切換角色 | +| `/companion off` | 關閉陪伴 | +| `/companion setup` | 設定 | +| `/companion todo` | 待辦：`todo add <內容> [due=YYYY-MM-DDTHH:MM]`、`todo done <編號>` | +| `/companion quiet [分鐘]` | 暫時安靜 | +| `ingest` skill | 解析單章小說（txt／md），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時自動使用 | + +```text +/companion status +/companion switch <角色> +/companion todo add 買牛奶 due=2026-10-15T18:00 +/companion todo done 1 +/companion quiet 30 +/companion off +``` + + +## 安裝 + +```bash +claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git +claude plugin install jsc-companion@jsc-marketplace +``` + +## 更新 + +```bash +claude plugin marketplace update jsc-marketplace +claude plugin update jsc-companion@jsc-marketplace +``` + +更新後需重新啟動 Claude Code 才會生效。 + +## 移除 + +```bash +claude plugin uninstall jsc-companion@jsc-marketplace +``` + +## 授權 + +[MIT License](../../LICENSE) diff --git a/plugins/jsc-herdr/README.md b/plugins/jsc-herdr/README.md new file mode 100644 index 0000000..b1ee07a --- /dev/null +++ b/plugins/jsc-herdr/README.md @@ -0,0 +1,45 @@ +

jsc-herdr

+ +# jsc-herdr + +控制 Herdr 終端多工器（workspace、tab、pane、指令與其他 agent），並可透過 gitea-issue 技能逐一實作 Gitea 議題。需安裝 Herdr 與 tea。 + +目前版本：0.0.3 + +## 指令 + +| 指令 | 說明 | +| --- | --- | +| `herdr` skill | 提到 Herdr 時自動使用，操作 pane、tab、workspace 與其他 agent（需 `HERDR_ENV=1`） | +| `/jsc-herdr:gitea-issue <議題連結>` | 每個議題一個 Claude agent、獨立 worktree 與 tab，監看至議題關閉後再提供下一批未被阻擋的議題 | + +```text +/jsc-herdr:gitea-issue https://gitea.example.com/owner/repo/issues/1 +``` + + +## 安裝 + +```bash +claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git +claude plugin install jsc-herdr@jsc-marketplace +``` + +## 更新 + +```bash +claude plugin marketplace update jsc-marketplace +claude plugin update jsc-herdr@jsc-marketplace +``` + +更新後需重新啟動 Claude Code 才會生效。 + +## 移除 + +```bash +claude plugin uninstall jsc-herdr@jsc-marketplace +``` + +## 授權 + +[MIT License](../../LICENSE) diff --git a/plugins/jsc-matt/README.md b/plugins/jsc-matt/README.md new file mode 100644 index 0000000..1e138a5 --- /dev/null +++ b/plugins/jsc-matt/README.md @@ -0,0 +1,82 @@ +

jsc-matt

+ +# jsc-matt + +Matt Pocock 的工程技能整套（grilling、spec/ticket、TDD、code review、領域建模等），改編自 mattpocock/skills。 + +目前版本：0.0.1 + +## 指令 + +### 工程 + +| 指令 | 說明 | +| --- | --- | +| `/jsc-matt:ask-matt` | 詢問哪個技能或流程適合目前情況 | +| `/jsc-matt:setup-matt-pocock-skills` | 設定此 repo 的議題追蹤、標籤與文件配置（每個 repo 先跑一次） | +| `/jsc-matt:grill-with-docs` | 追問式訪談，同時建立 CONTEXT.md 與 ADR | +| `/jsc-matt:to-spec` | 把對話整理成 spec 並發佈到議題追蹤 | +| `/jsc-matt:to-tickets` | 把計畫／spec 拆成帶阻擋關係的 tracer-bullet 票 | +| `/jsc-matt:implement` | 依 spec 或票實作 | +| `/jsc-matt:tdd` | 測試先行開發 | +| `/jsc-matt:code-review` | 依標準與 spec 審查變更 | +| `/jsc-matt:diagnosing-bugs` | 難解 bug 與效能退化的診斷流程 | +| `/jsc-matt:triage` | 把議題在分流狀態機中流轉 | +| `/jsc-matt:improve-codebase-architecture` | 掃描可深化之處，產出 HTML 報告後追問 | +| `/jsc-matt:codebase-design` | 深模組設計詞彙 | +| `/jsc-matt:domain-modeling` | 建立並打磨領域模型 | +| `/jsc-matt:prototype` | 建立可拋棄的原型以回答設計問題 | +| `/jsc-matt:research` | 對高可信來源調查並寫成 Markdown | +| `/jsc-matt:resolving-merge-conflicts` | 解決進行中的合併／rebase 衝突 | +| `/jsc-matt:wayfinder` | 把超大工作規劃成決策票地圖 | +| `/jsc-matt:wizard` | 產生互動式 bash 精靈，帶人完成只有人能做的步驟 | + +### 生產力 + +| 指令 | 說明 | +| --- | --- | +| `/jsc-matt:grill-me` | 追問式訪談以打磨計畫 | +| `/jsc-matt:grilling` | 徹底追問計畫、決策或想法 | +| `/jsc-matt:handoff` | 把對話濃縮成交接文件 | +| `/jsc-matt:teach` | 在此工作區教導新技能或概念 | +| `/jsc-matt:to-questionnaire` | 把無法自答的決定轉成問卷 | +| `/jsc-matt:wait-what` | 上一則沒講清楚，重新說明 | +| `/jsc-matt:writing-for-agents` | 撰寫給 agent 看的文件（skill、AGENTS.md、CLAUDE.md） | + +```text +/jsc-matt:setup-matt-pocock-skills +/jsc-matt:ask-matt +/jsc-matt:grill-with-docs +/jsc-matt:to-spec +/jsc-matt:to-tickets +/jsc-matt:implement +``` + +> 若已安裝官方 `mattpocock-skills`，建議移除以免重複。 + + +## 安裝 + +```bash +claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git +claude plugin install jsc-matt@jsc-marketplace +``` + +## 更新 + +```bash +claude plugin marketplace update jsc-marketplace +claude plugin update jsc-matt@jsc-marketplace +``` + +更新後需重新啟動 Claude Code 才會生效。 + +## 移除 + +```bash +claude plugin uninstall jsc-matt@jsc-marketplace +``` + +## 授權 + +[MIT License](../../LICENSE) diff --git a/plugins/jsc-statusbar/README.md b/plugins/jsc-statusbar/README.md new file mode 100644 index 0000000..00aa6dc --- /dev/null +++ b/plugins/jsc-statusbar/README.md @@ -0,0 +1,48 @@ +

jsc-statusbar

+ +# jsc-statusbar + +輸入框上方單行狀態列：模型、目錄、分支、5h/7d 額度與重置、context、CPU/記憶體/磁碟。 + +目前版本：0.0.4 + +## 指令 + +| 指令 | 說明 | +| --- | --- | +| `/statusbar on` | 開啟狀態列 | +| `/statusbar off` | 隱藏狀態列 | +| `/statusbar compact` | 改用極窄版 | + +```text +/statusbar on +/statusbar off +/statusbar compact +``` + + +## 安裝 + +```bash +claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git +claude plugin install jsc-statusbar@jsc-marketplace +``` + +## 更新 + +```bash +claude plugin marketplace update jsc-marketplace +claude plugin update jsc-statusbar@jsc-marketplace +``` + +更新後需重新啟動 Claude Code 才會生效。 + +## 移除 + +```bash +claude plugin uninstall jsc-statusbar@jsc-marketplace +``` + +## 授權 + +[MIT License](../../LICENSE)