02|工程流程全家桶(mattpocock/skills)

🎯 一行簡述:不是 27 個獨立工具,而是一條主流程——先把需求逼問清楚(grill)→ 寫成規格 → 拆成票 → TDD 實作 → 兩軸 Review。
- Repo:https://github.com/mattpocock/skills(MIT)
- 作者:Matt Pocock(aihero.dev)
- 穩定的 skill 分為
skills/engineering/與skills/productivity/兩類;另有skills/in-progress/(測試中,不在 plugin 內)與skills/misc/(少用的工具)

副標直接表態:「我每天用來做真正工程的 agent skills——不是 vibe coding」。開頭段落還點名 GSD、BMAD、Spec-Kit 這些方法論,說明它想解決同一批問題但走不同路線。
基本資料
| 項目 | 說明 |
|---|---|
| 出自 | Matt Pocock(個人),aihero.dev |
| 組織介紹 | Matt Pocock 是 TypeScript 教育者,GitHub 簡介寫著 Building Total TypeScript,並列出 Ex-Vercel 與 Stately 的經歷,現在經營 AI Hero。他的 skills 電子報在 README 中自稱約有 60,000 名開發者訂閱。 |
| 動機 | README 指出 Claude Code、Codex 等 coding agent 常見的失敗:做出來的東西不是你要的、用詞太冗長。他也認為 GSD、BMAD、Spec-Kit 這類方法會接管流程,讓人失去控制,bug 也難排查。 |
| 目的 | 提供小型、容易改、可組合、不綁特定模型的 skill,讓使用者保有對流程的控制,做真正的工程而不是 vibe coding。 |
| 使用方法 | Claude Code 執行 claude plugin install mattpocock-skills@claude-plugins-official;其他 agent 用 npx skills@latest add mattpocock/skills -a <agent>。兩種方式擇一,同時裝會讓每個 skill 出現兩次;用 npx 安裝挑選 skill 時要包含 setup-matt-pocock-skills。每個 repo 先跑一次 /setup-matt-pocock-skills,之後用 /grill-me 之類的指令開始。 |
🤖 直接請 Agent 安裝
看不懂底下的指令沒關係,把整段貼給你的 Agent(Claude Code/Cursor/Codex 等)即可:
請幫我安裝 Matt Pocock 的工程流程 Skills(github.com/mattpocock/skills,MIT):
1. 依我目前的 Agent 安裝:Claude Code 執行
claude plugin install mattpocock-skills@claude-plugins-official,
其他 Agent 執行 npx skills@latest add mattpocock/skills -a <agent>。
兩種方式擇一,不要同時裝。
2. 這個 repo 的穩定 skill 分 skills/engineering/ 與 skills/productivity/ 兩類,
先列出兩類底下各自有哪些 skill 給我看,讓我確認要全裝還是只挑幾個
(用 npx 安裝時要包含 setup-matt-pocock-skills)。
3. 裝完後確認 Skill 清單裡看得到這些項目,並簡短說明怎麼觸發
(例如 /grill-me、/to-spec、/tdd),提醒我在要用的 repo 先跑一次
/setup-matt-pocock-skills。
Matt Pocock(英國 Oxford)是全職的 TypeScript 教育者:
- Total TypeScript 作者——業界公認的 TS 學習標準課程
- 前 Vercel developer advocate、XState 核心團隊成員
- 現在經營 AI Hero,把 web 工程師訓練成 AI 工程師;其 AI Coding Cohort 有 2,500+ 學員用 Claude Code 實作兩週
- 入行前是聲音教練——這大概能解釋為什麼他的 Skill 這麼在意「怎麼問問題」
repo 的副標是 "Straight from my .agents directory"——這是他自己每天在用的東西,不是為了教學而寫的示範,這也是它比多數 skill 收藏可靠的原因。
它想解決的四種失敗
| 失敗模式 | 症狀 | 對應 Skill |
|---|---|---|
| Misalignment | Agent 誤解你要什麼,寫完才發現方向錯 | grill-me、grill-with-docs |
| Verbosity / 沒有共同語言 | 每次都要重講一遍領域名詞 | domain-modeling(GLOSSARY.md + ADR) |
| Broken Code | 沒有回饋迴圈,改一處壞三處 | tdd、diagnosing-bugs |
| Architectural Decay | 檔案越長越淺,越改越難改 | codebase-design、improve-codebase-architecture |
主流程
grill-me / grill-with-docs ← 逼問,直到達成共識
↓
to-spec ← 對話變規格(PRD),發到 issue tracker
↓
to-tickets ← 規格拆成 tracer-bullet 票,標註 blocking 邊
↓
implement ← 照票實作,在約定的 seam 上跑 /tdd(整份規格要平行做,改用 implement-spec)
↓
code-review ← Standards 軸 + Spec 軸,兩個子 agent 平行跑
第一次使用要先跑 setup-matt-pocock-skills,替這個 repo 設定 issue tracker(預設 GitHub,也支援 GitLab、本地 markdown,或自己描述的其他流程)、triage 標籤字彙、領域文件位置。
使用者手動呼叫的 Skill
| Skill | 特性 |
|---|---|
| ask-matt | 路由器。「我現在該用哪個 skill?」不記得整套流程時先問它 |
| grill-me | 把計畫攤成決策樹,每一輪把整個 frontier(所有前置已決的問題)一次問完,每題編號並附上建議答案,你回完再算下一輪,答完才准動手;能自己查的事實派子 agent 查,只把「決策」留給你。本身只是薄薄一層,實際流程在可重用的 grilling skill |
| grill-with-docs | 逼問的同時把術語與決策寫進 GLOSSARY.md 與 ADR(依序呼叫 grilling 與 domain-modeling),訪談結束就有文件 |
| to-spec | 不再訪談,純粹把當前對話合成一份規格並發到 tracker |
| to-tickets | 拆票,每張票是一顆 tracer bullet(垂直切片),並宣告它被哪些票 blocking |
| implement | 依規格/票實作,在約定的 seam 上跑 tdd,規律跑型別檢查與單一測試檔,最後跑一次完整測試,並以 code-review 收尾後 commit |
| implement-spec | 在同一條整合分支上實作整份規格:把票當成任務圖,對「已可開工」的那一批平行派出 implementer 子 agent,最後同樣以 code-review 收尾 |
| triage | 把 issue 與外部 PR 推過一台狀態機:分類 → 驗證 → 必要時 grill → 產出 agent 可直接接手的 brief。在 tracker 設定把外部 PR 當成請求入口時,PR 被視為「附程式碼的 issue」 |
| wayfinder | 給「一個 session 裝不下」的大工程:先命名 destination,再把路線畫成 tracker 上的決策票,一次解一張,直到路徑清晰。強調 plan, don't do |
| improve-codebase-architecture | 掃描 codebase 找 deepening 機會,產成視覺化 HTML 報告,選一個再 grill 進去 |
| handoff | 把對話壓縮成交接文件(存到 OS 暫存目錄),含「建議下一個 agent 使用哪些 skill」,且不重複已存在的 artifact,只給路徑 |
| teach | 有狀態的教學:把當前目錄當成教室,跨 session 保存學習進度 |
| to-questionnaire | 遇到自己答不了的決策,把它整理成一份 Markdown 問卷交給能回答的那個人,可非同步填寫或開會一起填;它逼問的是「這封問卷怎麼寄」(寄給誰、要回收什麼),不是問卷主題 |
| wait-what | 訊息看不懂的當下就叫它:agent 用白話、套用你的 GLOSSARY.md 詞彙,並補上你缺的脈絡重新講一遍 |
| retro | 一個 session 結束後,建議如何改善 coding agent 的環境(導覽、自動化檢查、編碼規範、steering 檔案、工具),最嚴重的排前面 |
| setup-matt-pocock-skills | 每個 repo 跑一次的初始化 |
模型可自動觸發的 Skill
| Skill | 特性 |
|---|---|
| tdd | 紅→綠→重構。重點不在迴圈本身,而在「什麼是值得留下的測試」、測試放哪、反模式清單;探索程式碼時會先讀 GLOSSARY.md 讓測試命名對齊領域語言 |
| diagnosing-bugs | 難 bug 與效能退化的紀律:建立回饋迴圈 → 最小化 → 假設 → 埋 instrument → 修 → 補回歸測試。跳過任何一階都要說明理由 |
| code-review | 兩軸審查:Standards(符合此 repo 的規範 + Fowler code smell 基線)與 Spec(是否忠實實作原始 issue/PRD),兩個子 agent 平行跑避免互相污染 context,最後彙整 |
| codebase-design | deep module 的共同字彙:小介面、大行為、乾淨 seam、可透過介面測試。明確要求不要用「component / service / API / boundary」代換術語 |
| domain-modeling | 主動打磨領域模型:挑戰用詞、用邊界情境壓力測試、當場更新 GLOSSARY.md 與 ADR。只是「讀」GLOSSARY.md 不算,這個 Skill 是用來改模型的 |
| pr | 規範 PR 描述的形狀:用最小的視覺化說明這次改動、附修改前後的證據、並判斷合併風險(單向門或雙向門,加上影響範圍) |
| wizard | 產生互動式 bash 精靈,帶人走完只有人能做的步驟:佈建基礎設施、設定憑證或 CI secrets、走過不熟的第三方後台、一次性的遷移或切換 |
| grilling | 逼問流程本體:決策樹、整個 frontier 一輪問完、每題附建議答案。grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture 都靠它 |
| writing-for-agents | 替 agent 寫文件的守則:skill、AGENTS.md/CLAUDE.md,以及任何靠指標讓 agent 讀到的文件 |
| prototype | 拋棄式原型:先確認「要回答的是哪個問題」,再決定形狀——邏輯/狀態問題做成單一可分享的 HTML 檔(自由操作按鈕加導覽式情境),UI 問題在同一條 route 上做成幾個差異很大、可切換的版本 |
| research | 開背景 agent 去讀一手來源(官方文件、原始碼、規格、first-party API),把附引用的發現寫成 repo 內的 Markdown,並沿用專案既有的存放慣例 |
最值得學的三個觀念
- 決策樹式訪談:一次一題、附建議答案、事實自己查——把人的時間只花在決策上。
- 兩軸 Review:「合不合規範」與「有沒有做到需求」是兩件事,要分開跑、分開報。
- 先約定 seam 再寫測試:
tdd與to-spec都要求先和你確認要在哪些 seam 測,把測試力氣花在關鍵路徑與複雜邏輯,而不是每個邊角。