docs: 插件 README 簡化為指令、說明、程式碼片段

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
root
2026-10-14 02:52:00 +00:00
co-authored by Claude Sonnet 5.5
parent 9d0c0ba154
commit 00d84f4070
5 changed files with 261 additions and 208 deletions
+3 -36
View File
@@ -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)
+51 -39
View File
@@ -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)
+11 -37
View File
@@ -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)
+179 -58
View File
@@ -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
```
+17 -38
View File
@@ -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)