From 9d0c0ba154b2c1b1fdd1a8a025c97b5613efa285 Mon Sep 17 00:00:00 2001
From: root <root@ct-ollama-claude-qwen.jsc.idv.me>
Date: Wed, 14 Oct 2026 02:48:13 +0000
Subject: [PATCH 1/2] =?UTF-8?q?docs:=20README=20=E6=94=B9=E7=82=BA?=
 =?UTF-8?q?=E7=B5=B1=E4=B8=80=E6=A0=BC=E5=BC=8F=EF=BC=8C=E5=90=84=E6=8F=92?=
 =?UTF-8?q?=E4=BB=B6=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 <noreply@anthropic.com>
---
 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 @@
+<p align="center"><img src="assets/icon.png" alt="jsc-marketplace" width="128"></p>
+
 # 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 @@
+<p align="center"><img src="../../assets/icon.png" alt="jsc-claude" width="96"></p>
+
+# 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 @@
+<p align="center"><img src="../../assets/icon.png" alt="jsc-companion" width="96"></p>
+
+# 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 @@
+<p align="center"><img src="../../assets/icon.png" alt="jsc-herdr" width="96"></p>
+
+# 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 @@
+<p align="center"><img src="../../assets/icon.png" alt="jsc-matt" width="96"></p>
+
+# 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 @@
+<p align="center"><img src="../../assets/icon.png" alt="jsc-statusbar" width="96"></p>
+
+# 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)

From 00d84f4070565c746d5d969de95d95ff01bad824 Mon Sep 17 00:00:00 2001
From: root <root@ct-ollama-claude-qwen.jsc.idv.me>
Date: Wed, 14 Oct 2026 02:52:00 +0000
Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=E6=8F=92=E4=BB=B6=20README=20?=
 =?UTF-8?q?=E7=B0=A1=E5=8C=96=E7=82=BA=E6=8C=87=E4=BB=A4=E3=80=81=E8=AA=AA?=
 =?UTF-8?q?=E6=98=8E=E3=80=81=E7=A8=8B=E5=BC=8F=E7=A2=BC=E7=89=87=E6=AE=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 plugins/jsc-claude/README.md    |  39 +-----
 plugins/jsc-companion/README.md |  90 ++++++------
 plugins/jsc-herdr/README.md     |  48 ++-----
 plugins/jsc-matt/README.md      | 237 ++++++++++++++++++++++++--------
 plugins/jsc-statusbar/README.md |  55 +++-----
 5 files changed, 261 insertions(+), 208 deletions(-)

diff --git a/plugins/jsc-claude/README.md b/plugins/jsc-claude/README.md
index e2e29a7..bab61b9 100644
--- a/plugins/jsc-claude/README.md
+++ b/plugins/jsc-claude/README.md
@@ -1,44 +1,11 @@
-<p align="center"><img src="../../assets/icon.png" alt="jsc-claude" width="96"></p>
-
 # jsc-claude
 
-用最簡單的方式解釋任何主題：大圖少字的 HTML 圖解（改編自 claude-community 的 eli5）。
-
-目前版本：0.0.1
-
 ## 指令
 
-| 指令 | 說明 |
-| --- | --- |
-| `/jsc-claude:eli5 <主題>` | 以大圖少字的 HTML 圖解簡單解釋主題 |
+### `/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
index 4da5429..0d1ca78 100644
--- a/plugins/jsc-companion/README.md
+++ b/plugins/jsc-companion/README.md
@@ -1,55 +1,67 @@
-<p align="center"><img src="../../assets/icon.png" alt="jsc-companion" width="96"></p>
-
 # 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），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時自動使用 |
+### `/companion status`
+
+查看目前角色與狀態。
 
 ```text
 /companion status
-/companion switch <角色>
+```
+
+### `/companion switch <角色>`
+
+切換角色。
+
+```text
+/companion switch 小明
+```
+
+### `/companion setup`
+
+進行設定。
+
+```text
+/companion setup
+```
+
+### `/companion todo add <內容> [due=YYYY-MM-DDTHH:MM]`
+
+新增待辦，可指定到期時間。
+
+```text
 /companion todo add 買牛奶 due=2026-10-15T18:00
+```
+
+### `/companion todo done <編號>`
+
+將待辦標為完成。
+
+```text
 /companion todo done 1
+```
+
+### `/companion quiet [分鐘]`
+
+暫時安靜，不主動關心。
+
+```text
 /companion quiet 30
+```
+
+### `/companion off`
+
+關閉陪伴。
+
+```text
 /companion off
 ```
 
+### `ingest skill`
 
-## 安裝
+解析單章小說（txt／md），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時自動使用。
 
-```bash
-claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git
-claude plugin install jsc-companion@jsc-marketplace
+```text
+幫我用 ingest 解析 chapter1.md，章節編號 1
 ```
-
-## 更新
-
-```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
index b1ee07a..940c9be 100644
--- a/plugins/jsc-herdr/README.md
+++ b/plugins/jsc-herdr/README.md
@@ -1,45 +1,19 @@
-<p align="center"><img src="../../assets/icon.png" alt="jsc-herdr" width="96"></p>
-
 # 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，監看至議題關閉後再提供下一批未被阻擋的議題 |
+### `herdr skill`
+
+提到 Herdr 時自動使用，操作 pane、tab、workspace 與其他 agent（需 HERDR_ENV=1）。
+
+```text
+用 Herdr 開一個新 tab 執行 npm test
+```
+
+### `/jsc-herdr:gitea-issue <議題連結>`
+
+每個議題交給一個 Claude agent，使用獨立 worktree 與 tab，監看至議題關閉後再提供下一批未被阻擋的議題。需 Herdr 與 tea。
 
 ```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
index 1e138a5..b210827 100644
--- a/plugins/jsc-matt/README.md
+++ b/plugins/jsc-matt/README.md
@@ -1,82 +1,203 @@
-<p align="center"><img src="../../assets/icon.png" alt="jsc-matt" width="96"></p>
-
 # jsc-matt
 
-Matt Pocock 的工程技能整套（grilling、spec/ticket、TDD、code review、領域建模等），改編自 mattpocock/skills。
-
-目前版本：0.0.1
-
 ## 指令
 
-### 工程
+### `/jsc-matt:setup-matt-pocock-skills`
 
-| 指令 | 說明 |
-| --- | --- |
-| `/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） |
+設定此 repo 的議題追蹤、標籤與文件配置（每個 repo 先跑一次）。
 
 ```text
 /jsc-matt:setup-matt-pocock-skills
-/jsc-matt:ask-matt
-/jsc-matt:grill-with-docs
+```
+
+### `/jsc-matt:ask-matt`
+
+詢問哪個技能或流程適合目前情況。
+
+```text
+/jsc-matt:ask-matt 我想重構認證模組，該用哪個流程？
+```
+
+### `/jsc-matt:grill-with-docs`
+
+追問式訪談，同時建立 CONTEXT.md 與 ADR。
+
+```text
+/jsc-matt:grill-with-docs 我打算加入付款功能
+```
+
+### `/jsc-matt:to-spec`
+
+把對話整理成 spec 並發佈到議題追蹤。
+
+```text
 /jsc-matt:to-spec
+```
+
+### `/jsc-matt:to-tickets`
+
+把計畫或 spec 拆成帶阻擋關係的 tracer-bullet 票。
+
+```text
 /jsc-matt:to-tickets
-/jsc-matt:implement
 ```
 
-> 若已安裝官方 `mattpocock-skills`，建議移除以免重複。
+### `/jsc-matt:implement`
 
+依 spec 或票實作。
 
-## 安裝
-
-```bash
-claude plugin marketplace add https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace.git
-claude plugin install jsc-matt@jsc-marketplace
+```text
+/jsc-matt:implement #12
 ```
 
-## 更新
+### `/jsc-matt:tdd`
 
-```bash
-claude plugin marketplace update jsc-marketplace
-claude plugin update jsc-matt@jsc-marketplace
+測試先行開發。
+
+```text
+/jsc-matt:tdd 新增優惠碼驗證
 ```
 
-更新後需重新啟動 Claude Code 才會生效。
+### `/jsc-matt:code-review`
 
-## 移除
+依標準與 spec 審查自某個起點以來的變更。
 
-```bash
-claude plugin uninstall jsc-matt@jsc-marketplace
+```text
+/jsc-matt:code-review main
 ```
 
-## 授權
+### `/jsc-matt:diagnosing-bugs`
 
-[MIT License](../../LICENSE)
+難解 bug 與效能退化的診斷流程。
+
+```text
+/jsc-matt:diagnosing-bugs 登入偶爾會 500
+```
+
+### `/jsc-matt:triage`
+
+把議題在分流狀態機中流轉。
+
+```text
+/jsc-matt:triage
+```
+
+### `/jsc-matt:improve-codebase-architecture`
+
+掃描可深化之處，產出 HTML 報告後追問。
+
+```text
+/jsc-matt:improve-codebase-architecture
+```
+
+### `/jsc-matt:codebase-design`
+
+深模組設計詞彙，用於設計或改善模組介面。
+
+```text
+/jsc-matt:codebase-design 設計快取模組的介面
+```
+
+### `/jsc-matt:domain-modeling`
+
+建立並打磨領域模型。
+
+```text
+/jsc-matt:domain-modeling 整理訂單相關術語
+```
+
+### `/jsc-matt:prototype`
+
+建立可拋棄的原型以回答設計問題。
+
+```text
+/jsc-matt:prototype 購物車狀態模型
+```
+
+### `/jsc-matt:research`
+
+對高可信來源調查，寫成 Markdown。
+
+```text
+/jsc-matt:research Postgres 邏輯複寫的限制
+```
+
+### `/jsc-matt:resolving-merge-conflicts`
+
+解決進行中的合併或 rebase 衝突。
+
+```text
+/jsc-matt:resolving-merge-conflicts
+```
+
+### `/jsc-matt:wayfinder`
+
+把超大工作規劃成決策票地圖。
+
+```text
+/jsc-matt:wayfinder 遷移到新的計費系統
+```
+
+### `/jsc-matt:wizard`
+
+產生互動式 bash 精靈，帶人完成只有人能做的步驟。
+
+```text
+/jsc-matt:wizard 設定 CI 密鑰
+```
+
+### `/jsc-matt:grill-me`
+
+追問式訪談以打磨計畫。
+
+```text
+/jsc-matt:grill-me 我想自建通知服務
+```
+
+### `/jsc-matt:grilling`
+
+徹底追問計畫、決策或想法。
+
+```text
+/jsc-matt:grilling 我要把資料庫換成 Postgres
+```
+
+### `/jsc-matt:handoff`
+
+把對話濃縮成交接文件。
+
+```text
+/jsc-matt:handoff
+```
+
+### `/jsc-matt:teach`
+
+在此工作區教導新技能或概念。
+
+```text
+/jsc-matt:teach Rust 的所有權
+```
+
+### `/jsc-matt:to-questionnaire`
+
+把無法自答的決定轉成問卷。
+
+```text
+/jsc-matt:to-questionnaire
+```
+
+### `/jsc-matt:wait-what`
+
+上一則沒講清楚，重新說明。
+
+```text
+/jsc-matt:wait-what
+```
+
+### `/jsc-matt:writing-for-agents`
+
+撰寫給 agent 看的文件（skill、AGENTS.md、CLAUDE.md）。
+
+```text
+/jsc-matt:writing-for-agents 改寫 CLAUDE.md
+```
diff --git a/plugins/jsc-statusbar/README.md b/plugins/jsc-statusbar/README.md
index 00aa6dc..e024303 100644
--- a/plugins/jsc-statusbar/README.md
+++ b/plugins/jsc-statusbar/README.md
@@ -1,48 +1,27 @@
-<p align="center"><img src="../../assets/icon.png" alt="jsc-statusbar" width="96"></p>
-
 # jsc-statusbar
 
-輸入框上方單行狀態列：模型、目錄、分支、5h/7d 額度與重置、context、CPU/記憶體/磁碟。
-
-目前版本：0.0.4
-
 ## 指令
 
-| 指令 | 說明 |
-| --- | --- |
-| `/statusbar on` | 開啟狀態列 |
-| `/statusbar off` | 隱藏狀態列 |
-| `/statusbar compact` | 改用極窄版 |
+### `/statusbar on`
+
+開啟狀態列。
 
 ```text
 /statusbar on
+```
+
+### `/statusbar off`
+
+隱藏狀態列。
+
+```text
 /statusbar off
+```
+
+### `/statusbar compact`
+
+改用極窄版狀態列。
+
+```text
 /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)