docs: 插件 README 簡化為指令、說明、程式碼片段
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
root
co-authored by
Claude Sonnet 5.5
Claude Sonnet 5.5
parent
9d0c0ba154
commit
00d84f4070
+179
-58
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user