Merge pull request 'docs: README 改為統一格式，各插件新增獨立 README' (#29) from docs/readme-restructure into main
Reviewed-on: https://gitea.jsc.idv.tw/jiantw83/jsc-marketplace/pulls/29
This commit was merged in pull request #29.
This commit is contained in:
@@ -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`。
|
||||
|
||||
@@ -0,0 +1,11 @@
|
||||
# jsc-claude
|
||||
|
||||
## 指令
|
||||
|
||||
### `/jsc-claude:eli5 <主題>`
|
||||
|
||||
以大圖少字的 HTML 圖解簡單解釋主題。
|
||||
|
||||
```text
|
||||
/jsc-claude:eli5 區塊鏈
|
||||
```
|
||||
@@ -0,0 +1,67 @@
|
||||
# jsc-companion
|
||||
|
||||
## 指令
|
||||
|
||||
### `/companion status`
|
||||
|
||||
查看目前角色與狀態。
|
||||
|
||||
```text
|
||||
/companion status
|
||||
```
|
||||
|
||||
### `/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），逐一詢問合併、新建或略過後寫入角色資料；提供章節檔或要求建立角色時自動使用。
|
||||
|
||||
```text
|
||||
幫我用 ingest 解析 chapter1.md，章節編號 1
|
||||
```
|
||||
@@ -0,0 +1,19 @@
|
||||
# jsc-herdr
|
||||
|
||||
## 指令
|
||||
|
||||
### `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
|
||||
```
|
||||
@@ -0,0 +1,203 @@
|
||||
# jsc-matt
|
||||
|
||||
## 指令
|
||||
|
||||
### `/jsc-matt:setup-matt-pocock-skills`
|
||||
|
||||
設定此 repo 的議題追蹤、標籤與文件配置（每個 repo 先跑一次）。
|
||||
|
||||
```text
|
||||
/jsc-matt:setup-matt-pocock-skills
|
||||
```
|
||||
|
||||
### `/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`
|
||||
|
||||
依 spec 或票實作。
|
||||
|
||||
```text
|
||||
/jsc-matt:implement #12
|
||||
```
|
||||
|
||||
### `/jsc-matt:tdd`
|
||||
|
||||
測試先行開發。
|
||||
|
||||
```text
|
||||
/jsc-matt:tdd 新增優惠碼驗證
|
||||
```
|
||||
|
||||
### `/jsc-matt:code-review`
|
||||
|
||||
依標準與 spec 審查自某個起點以來的變更。
|
||||
|
||||
```text
|
||||
/jsc-matt:code-review main
|
||||
```
|
||||
|
||||
### `/jsc-matt:diagnosing-bugs`
|
||||
|
||||
難解 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
|
||||
```
|
||||
@@ -0,0 +1,27 @@
|
||||
# jsc-statusbar
|
||||
|
||||
## 指令
|
||||
|
||||
### `/statusbar on`
|
||||
|
||||
開啟狀態列。
|
||||
|
||||
```text
|
||||
/statusbar on
|
||||
```
|
||||
|
||||
### `/statusbar off`
|
||||
|
||||
隱藏狀態列。
|
||||
|
||||
```text
|
||||
/statusbar off
|
||||
```
|
||||
|
||||
### `/statusbar compact`
|
||||
|
||||
改用極窄版狀態列。
|
||||
|
||||
```text
|
||||
/statusbar compact
|
||||
```
|
||||
Reference in New Issue
Block a user