mattpocock/skills 是 Matt Pocock 開源的一組工程型 AI agent 技能,repo 自述定位為 real engineering,而非 vibe coding。它把開發流程拆成小型、可組合、可修改的 skill:先用 grill-with-docs 釐清需求,用 to-prd 轉成 PRD,用 to-issues 拆成 vertical slice,用 tdd 實作,再以 review、diagnose、improve-codebase-architecture 收尾。本手冊涵蓋安裝與 setup、技能總覽、推薦工作流、Prompt 範本,以及一個登入功能的完整實作範例。
mattpocock/skills 不是單一 prompt,而是一組工程型 AI agent workflow。核心用途是把一個功能從模糊想法推到上線:先把需求講清楚,再轉 PRD,再拆 issue,再用 TDD 實作,再 review、diagnose、整理架構。Repo 自述定位為 real engineering,而非 vibe coding,並強調這些 skill 是小型、可組合、可修改的 agent skills。
每個 skill 對應一個明確的工程動作,而不是一句通用提示。/grill-with-docs 負責挑戰需求、對齊 domain language;/to-prd 把對話與 codebase 理解合成 PRD;/to-issues 把 PRD 拆成可獨立實作的 vertical slice;/tdd 以 red-green-refactor 實作;/review 沿 Standards 與 Spec 兩軸審查 diff。技能之間靠 repo 內的 issue tracker 與 domain docs 串接,因此 setup 步驟會先把這些位置設定好。
重點不在省 prompt,而在把流程固定下來。先釐清、再規劃、再實作、再審查的順序被寫進每個 skill 的設計裡。官方 README 也指出 agent 會加速 software entropy,因此需要定期用 /zoom-out 與 /improve-codebase-architecture 關注 system design。
官方 quickstart 用一行 npx 安裝。安裝時選你要使用的 coding agent,並務必勾選 /setup-matt-pocock-skills。
安裝完成後,在你的 coding agent 內先跑一次 setup skill。它會設定 repo 的 issue tracker、triage labels 與 domain docs 位置,供後續 /to-prd、/to-issues、/tdd、/diagnose 等技能讀取。
setup 時把 issue tracker、triage labels 與 domain doc 佈局一併指定,後續技能就有固定的讀寫位置。
/to-prd 會把 PRD 發佈到設定好的 tracker,/grill-with-docs 會在術語釐清後更新 CONTEXT.md。跳過 setup,下游技能就沒有共用的讀寫位置。
官方 reference 列出的 engineering skills 共 10 個:diagnose、grill-with-docs、triage、improve-codebase-architecture、setup-matt-pocock-skills、tdd、to-issues、to-prd、zoom-out、prototype。下表再加上工作流常用的 /review 與 /handoff,依工作階段分組。實務上記住 grill-with-docs、to-prd、to-issues、tdd、review 五個核心,就能跑完一輪。
| 情境 | 不要這樣 | 正確用法 |
|---|---|---|
| 需求還很模糊 | 直接叫 agent 開工 | /grill-with-docs |
| 大功能 | 叫 agent 一次做完 | /to-prd → /to-issues → 每個 issue /tdd |
| Bug | 直接叫 agent 修 | /diagnose 先建立 repro loop |
| 測試 | 叫 agent 補 coverage | /tdd 測 observable behavior |
| Review | 叫 agent「看看有沒有問題」 | /review main,指定 fixed point |
| 架構變亂 | 叫 agent refactor all | /zoom-out → /improve-codebase-architecture |
先 setup repo 規則,再用 grill-with-docs 把需求問清楚並寫入 CONTEXT.md / ADR,接著 to-prd 整理成 PRD,to-issues 拆成 thin vertical slice,每個 issue 用 tdd 實作,最後 review main 對比 main branch 檢查。
/to-issues 的設計重點是 tracer bullet vertical slices:每個 issue 都應該可驗證、可 demo、端到端,而不是只做 schema、API、UI 其中一層。
先 diagnose 建立可重現的 feedback loop,再用 tdd 加 regression test 並修復,最後 review main 確認沒有破壞既有行為。diagnose 的流程是:建立 feedback loop → reproduce → minimise → hypothesise → instrument → fix → regression-test,強調先有可自動跑的 pass/fail signal,而不是直接猜 bug。
適合 agent 寫太快後 codebase 變亂的情況。先 zoom-out 建立系統全貌,再用 improve-codebase-architecture 找出 interface 太淺、複雜度外漏的地方,改動以 tdd 護住,最後 review main。官方 README 指出 agent 會加速 software entropy,因此需要定期關注 system design。
以下範本對應流程中的關鍵階段,可直接貼用後替換方括號內容。/grill-with-docs 要求 agent 一次問一個問題、必要時檢查 codebase,並在每個問題給出建議答案;能在 codebase 找到答案時就去看 code,而不是問你。
/to-prd 不重新訪談使用者,而是把目前 conversation context 與 codebase understanding 合成 PRD,涵蓋 problem、solution、user stories、implementation decisions、testing decisions、out of scope。
/tdd 的核心原則是測 public interface 的 observable behavior,不測 implementation details;流程是 vertical red-green loop,而不是一次寫完所有 test 再一次寫完 implementation。
/review 會把 diff 對固定點比較,沿 Standards 與 Spec 兩軸檢查,並參考 issue references、PRD/spec、repo coding standards、CONTEXT、ADR、config 等作為依據。
以下示範一個 email/password 登入功能,從 /grill-with-docs 釐清,經 /to-prd、/to-issues 拆解,再用 /tdd 實作第一個 issue,最後 /review main 收尾。
grill-with-docs 在問問題前先去讀 src/auth/*,把能在 codebase 找到的答案直接查出來,而不是丟回給你。to-issues 把登入拆成可獨立 demo 的 vertical slice,並標出 AFK 與 HITL。tdd 一次只做一個 behavior,刻意不提前實作 #124 的錯誤處理。review 沿 Spec 軸確認沒有把 out-of-scope 的 OAuth 偷渡進來。
/grill-with-docs 把需求問清楚、對齊 domain language,再進入實作。
/to-prd → /to-issues → 每個 issue 用 /tdd,把工作切成可驗證的 vertical slice。
/diagnose 建立可重現的 repro loop,有 pass/fail signal 再動手。
/tdd 測 observable behavior,不測 implementation details。
/review main 對比 main branch,沿 Standards 與 Spec 兩軸,而不是泛問「看看有沒有問題」。
/zoom-out 建立全貌,再用 /improve-codebase-architecture 鎖定 interface 太淺、複雜度外漏的地方。
只裝這 6 個就足以跑完一輪工程流程。Debug 多的 repo 再加 /diagnose;大型 codebase 再加 /zoom-out、/improve-codebase-architecture、/handoff。