🛠️ mattpocock/skills:小塊、可改、給真的在寫程式的人
✅ 這篇做什麼:介紹 mattpocock/skills。Matt Pocock 把自己 .agents 目錄裡每天在用的 skills 公開出來。他的對照對象是 GSD、BMAD、Spec-Kit 這類會把流程整個包走的做法:那些套件幫你排程序,但也把控制權拿走,流程本身出錯時不好修。這包故意做成小的、好改的、可以拼起來的,而且不綁某個模型。
倉庫說明寫 “Skills for Real Engineers”,副標是 straight from my .agents directory。他要的是日常工程,不是 vibe coding。電子報報名人數他寫約 6 萬,連結在 aihero.dev。技能索引也可以從 skills.sh/mattpocock/skills 看。
🛠️ 怎麼裝
外掛會自己更新。npx skills 是把可編輯的檔案複製進專案,之後要自己更新。兩種都裝的話,每份 skill 會出現兩次,所以一個 agent 只選一種。
Claude Code:
1 | claude plugin install mattpocock-skills@claude-plugins-official |
Codex:
1 | codex plugin marketplace add mattpocock/skills |
Codex 會在啟動時更新。GitHub Copilot CLI:
1 | copilot plugin marketplace add mattpocock/skills |
Copilot 還要在 ~/.copilot/settings.json 加一次:
1 | { |
VS Code 用 Chat: Install Plugin From Source,填 https://github.com/mattpocock/skills,每天更新。
Gemini CLI 要自己重跑才算更新:
1 | gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering |
其他 agent,或想拿到可改的檔案:
1 | npx skills@latest add mattpocock/skills -a <agent> |
-a 可以是 cursor、opencode、devin、windsurf、amp、pi。省略的話安裝程式會問。選 skill 時把 setup-matt-pocock-skills 勾進去。更新用 npx skills@latest update;有新 skill 要再跑一次 add。
裝好後,每個 repo 跑一次 /setup-matt-pocock-skills。它問三件事:issue tracker(GitHub、GitLab、本地檔案,或你自己描述的別的)、triage 用的標籤、文件要存哪。
🧩 他在補的四種失敗
README 把常見翻車收成四條,每條都掛一個 skill,而不是再發明一套總流程。
Agent 做的不是你要的。他引 The Pragmatic Programmer:沒有人一開始就完全知道自己要什麼。對人是這樣,對 agent 也是。解法是 grilling,讓 agent 把設計樹上的分支問完。非程式用 /grill-me,寫程式用 /grill-with-docs。後者多做一件事:邊問邊收共用術語。他說這兩個是最常被用的,每次要改東西之前都先跑。
Agent 太囉嗦。Eric Evans 講的 ubiquitous language 被拿來當理由:人和領域專家一開始不說同一套話,agent 被丟進專案後也是邊猜術語邊寫,一句話拆成二十個字。/grill-with-docs 會把術語寫進 GLOSSARY.md,難解釋的決定寫進 ADR。他舉自己的 course-video-manager:改前是「課程裡某一節被做成檔案系統上的真實位置出了問題」,改後是 “materialization cascade”。那份舊檔在釘選的 commit 裡還叫 CONTEXT.md,後來才改名。副作用他列了三個:命名跟著詞彙走、agent 比較找得到路、思考時少燒 token。
程式不能跑。回饋速度是上限,一次接太大的任務就不該接,這句也來自 The Pragmatic Programmer。對齊了需求還是寫出壞程式,通常是回饋迴圈不夠:型別、瀏覽器、自動測試。測試這邊他要 red-green-refactor,先寫會失敗的測試。/tdd 就是這圈。難抓的 bug 和效能退步走 /diagnosing-bugs:先做出會在這個 bug 上變紅的迴圈,再縮小、提假設、加觀測、修、補回歸測試,一階段過一關。
程式變成一坨。Kent Beck 要每天投資設計,Ousterhout 要深模組:很多行為,小介面。Agent 把寫碼加快,熵也加快。/to-spec 在寫規格前會先問你要動哪些模組。/improve-codebase-architecture 掃一遍加深的機會,交候選清單。他建議隔幾天跑一次。這是調查,不是救援;老程式庫找得到候選,不會替你把泥團拆開。
🗂️ 誰可以呼叫
分法只有一軸。User-invoked 只有你打出指令才會跑,工作是編排。Model-invoked 你也可以打,任務對上時 agent 自己也會拿。前者可以呼叫後者,不能再呼叫另一個 user-invoked。
工程、每天會用到的,user-invoked:
| 指令 | 做什麼 |
|---|---|
/ask-matt |
問現在該用哪個 skill 或流程 |
/grill-with-docs |
盤問,同時改 GLOSSARY.md 和 ADR |
/triage |
依 triage 角色的狀態機移動 issue |
/improve-codebase-architecture |
掃加深機會,出一份 HTML 報告,再針對你選的那項繼續問 |
/to-spec |
把已經談過的內容收成規格,發到 issue tracker。不再面試一輪 |
/to-tickets |
拆成 tracer-bullet tickets,寫明阻擋關係。本地檔或 tracker 上的 blocking link 都可以 |
/implement |
照規格或 tickets 做,約定好的接縫走 /tdd,提交前走 /code-review |
/implement-spec |
整份規格放一條整合分支,依任務圖把就緒的票交給實作 subagent,收尾仍是 /code-review |
/wayfinder |
大到一次 session 放不下的工作,拆成 tracker 上的決策票,一張一張解到路清楚 |
/retro |
session 結束後,對導航、自動檢查、規範、steering 檔、工具提改進,嚴重的先講 |
Model-invoked 裡比較常被上面那些叫到的:/tdd、/diagnosing-bugs、/domain-modeling、/codebase-design(深模組:小介面後面放很多行為,接縫乾淨,透過介面測)、/code-review(標準和規格兩條軸,各開 subagent,避免互相污染)、/prototype(用完即丟,狀態問題用單份 HTML,UI 用同一路由切幾種差很多的版本)、/pr(PR 內文先給最小的對照,再給前後證據,並標這是單向門還是雙向門,以及爆炸半徑)、/research(對一手來源查完,寫成倉庫裡有引用的 Markdown,當背景 agent 跑)、/wizard(產生互動式 bash,帶人做只有人能做的步驟:開帳號、塞 CI secret、走第三方後台、一次性切換)。
生產力、不限寫程式:/grill-me 把計劃問到設計樹的分支都有答案。/handoff 把這輪對話壓成給下一個 agent 的交接文件。/teach 用目前目錄當有狀態的教學工作區,分多輪教。/to-questionnaire 把你一個人答不了的決定做成 Markdown 問卷,問的是寄給誰、要收回什麼,不是題目本身。/wait-what 在一句話沒聽懂時用,agent 用 GLOSSARY.md 的詞再講一次。底下的 /grilling 是面試原語,/grill-me、/grill-with-docs、/triage、/wayfinder、/improve-codebase-architecture 都站在它上面。/writing-for-agents 則是寫給 agent 讀的文件:skill、AGENTS.md、CLAUDE.md,以及任何靠指標才會被打開的文件。
💬 在 Codex 裡怎麼接
README 在 Codex 安裝步驟後面用的是斜線指令,例如 /grill-me。這段依 2026-10-21 讀到的 main。若你這台 Codex 只認 $grill-me,把下面的 / 換成 $。我沒有在本機已安裝的外掛裡核對觸發字串。
先跑過 /setup-matt-pocock-skills。/to-spec、/to-tickets、/wayfinder 都要知道 issue tracker 在哪;沒設定時,skill 會叫你先跑 setup。
文件寫明的先後不是一條固定管線,各 skill 只做自己那件事:
/grill-me只呼叫grilling,把計劃問完,不寫文件。/grill-with-docs同時呼叫grilling與domain-modeling,會改GLOSSARY.md和 ADR。/to-spec不再提問。它把已經談過的內容收成規格,發到 tracker,並貼ready-for-agent。seam(對外可觀察的測試邊界)會先跟你對過。/to-tickets拆成可獨立驗證的垂直切片,先把清單給你看,同意才發表。不關父 issue。/wayfinder給一次 session 放不下、路還不清楚的工作。預設只做決策、不實作。問完若沒有霧,它應停下來問你,不要硬畫地圖。/tdd是先紅後綠。寫測試前先列出 seam 並等你確認。一次一個 seam。重構不在這個迴圈,留給code-review。/implement照規格或票做,接縫走/tdd,中間跑型別檢查與單一測試,結束跑整個測試套件和/code-review,然後 commit 到目前分支。
下面的取捨是用法建議,不是 README 規定的順序。需求還說不清,先 grill,不要先 /to-spec。會改程式、名詞會重複,用 /grill-with-docs;還不碰 repo,用 /grill-me。驗收已經講得出口、範圍在一個模組,直接 /tdd。要留給之後的 agent,grill 完再 /to-spec,看過規格才 /implement。要拆多張票,規格點頭後再 /to-tickets,一張一張做。/wayfinder 只放在目的地仍是霧、而且明顯超過一輪的時候。
改錯字、改一句文案、改一個你已經指出的常數,直接下指令。不必開這些 skill。
/implement 會 commit。不想讓它提交時,在 prompt 寫「不要 commit、不要 push」。這是覆寫作者預設,skill 裡沒有開關。
每個階段分開貼。<...> 換成你的句子。
需求不清楚、會動到程式:
1 | /grill-with-docs |
還不碰程式:
1 | /grill-me |
bug 或小功能,驗收已經清楚:
1 | /tdd |
對話已經夠,要收成規格:
1 | /to-spec |
規格你已經看過:
1 | /to-tickets <規格連結或 issue 編號> |
目的地仍不清楚,而且超過一輪:
1 | /wayfinder |
之後一輪只解一張決策票(research 票是文件寫的例外):
1 | /wayfinder <地圖連結> |
一張票開始做:
1 | /implement <票的編號或 URL> |
你要看的產出:grill 問的問題有沒有改到驗收範圍;/grill-with-docs 還要看 GLOSSARY.md 和 ADR 的名詞是不是你會用的。/to-spec 看 tracker 上的問題、做法、驗收、Out of Scope,以及 seam 有沒有先點頭。/to-tickets 看每張票是否單獨可驗證,阻擋對不對。本地 tracker 的檔在 .scratch/<feature-slug>/issues/,一票一檔。/wayfinder 看地圖的 Destination、Decisions so far、Not yet specified、Out of scope。/tdd 和 /implement 先看紅燈是不是失敗在該行為上,再看綠燈輸出和 diff 有沒有超出這張票。