今天再來聊一個新出爐的 Skills 倉庫，作者是 TypeScript 圈無人不知的 Matt Pocock，倉庫名簡單粗暴 —— mattpocock/skills，slogan 是：Skills for Real Engineers. Straight from my .claude directory.（真正工程師用的 Skills，直接來自我的 .claude 目錄）

直接把自己每天在用的那一系列配置端出來給你看，這種誠意我服

先認識一下 Matt Pocock

如果你是寫前端、寫全棧的工程師，大概率繞不開他

我簡單梳理幾個標簽：

• Total TypeScript 創始人 ：totaltypescript幾乎是英文世界 TypeScript 教學的事實標準，從 Beginner's TypeScript 免費入門，到 Total TypeScript Essentials、Pro 進階課，再到面向庫作者的 Type Transformations、Generics 專題，幾乎覆蓋了一個 TS 工程師從入門到 wizard 的全部路徑

• TS 布道師 ：他在 Twitter/X 上每天發 TS 小技巧、類型體操、踩坑分享，長期是 TypeScript 話題的頭部賬號，很多 PR 給 TS 官方的人也跟他互相 cue

• 前 XState/Stately DX ：早年在 Stately（XState 狀態機背后的公司）做開發者體驗，把 XState 那套相對硬核的狀態機概念用人話講清楚，那一波文檔和視頻影響了一代寫狀態機的前端

• AI Hero ：現在他在做 aihero.dev，主打 AI 時代工程師的實戰教學，光這個 Skills newsletter 就有大約 6 萬開發者訂閱

• 開源工具作者 ： @total-typescript/shoehorn 、 ts-reset 這些小而美的 TS 工具庫都出自他手，社區里很多團隊在用

Matt Pocock 是那種既能把類型玩到飛起，又特別擅長把復雜概念講明白的人，他下場談 AI 編程怎么落地，含金量是不一般

這個 Skills 倉庫到底是什么

倉庫名：mattpocock/skills

副標題：My agent skills that I use every day to do real engineering - not vibe coding（我每天做真工程用的 agent skills，不是 vibe coding）

Matt 自己在 README 開頭放了句很有態度的話：

? Approaches like GSD, BMAD, and Spec-Kit try to help by owning the process. But while doing so, they take away your control and make bugs in the process hard to resolve.（GSD、BMAD、Spec-Kit 這類方法論想幫你接管整個流程，代價是你失去了控制權，流程里的 bug 也變得很難處理）

他做這些 Skills 的理念正好相反：小、易改、可組合，跟任何模型都能搭

跟 Anthropic 官方那套偏完整框架的 skill、Addy Osmani 風格偏教學演示的 skill 比，Matt 的風格更像是老司機的私房 dotfile，每條都對應他在 Claude Code、Codex 這些 agent 上踩過的坑

安裝方式

倉庫給的是 30 秒上手版，用的是社區做的 skills.sh 安裝器：

npx skills@latest add mattpocock/skills

跑完會讓你勾選要哪些 skill，我直接全選！

裝到哪個 agent（Claude Code / Codex 等）

然后在 agent 里執行：

/setup-matt-pocock-skills

它會問你三件事：

1. issue tracker 用啥（GitHub / Linear / 本地文件）

2. triage 時用什么 label 分類

3. 文檔放在哪個目錄

回答完，整套就跟你的 repo 配好了

不想用 skills.sh 也行，倉庫就是標準的 Claude Code skill 結構，clone 下來扔進 ~/.claude/skills/ 或者項目里的 .claude/ 都能用

倉庫分了哪幾類

倉庫 skills/ 下分成五個文件夾，老章看下來這個分類法本身就很值得學：

目錄

定位

engineering/

每天寫代碼用的， 主力

productivity/

通用工作流，跟代碼無關也能用

misc/

留著但用得少

personal/

跟他自己機器配置綁定的，不推薦外人用

in-progress/

還在打磨的草稿

deprecated/

已棄用

這種分層本身就是個工程實踐 —— 公開推廣的、私人用的、半成品的，分得清清楚楚，避免一個倉庫里啥都往外推

倉庫目錄結構 重點是 engineering 這一組

這是 Matt 想真正給你的核心，10 個 skill，老章按他 README 里講的 4 個失敗模式串一下：

失敗模式 ：Agent 沒干你想要的事 → 對齊

• /grill-me （productivity）：讓 agent 反過來盤問你，把每個分支拍清楚

• /grill-with-docs （engineering）：上面的加強版，盤問的同時幫你寫 CONTEXT.md 和 ADR

Matt 自己說這倆是他最常用的兩個 skill，每次準備改東西前都會先跑一遍

失敗模式 ：Agent 啰嗦得要命 → 共享語言

核心思路是給項目建一份 CONTEXT.md，把項目里的"行話"沉淀下來

他舉了個例子，同一句話：

• BEFORE：There's a problem when a lesson inside a section of a course is made 'real'（一節課在被"實例化"到文件系統時出問題）

• AFTER：There's a problem with the materialization cascade（materialization cascade 出問題了）

后者短得多，agent 思考用的 token 也少得多，變量、函數、文件命名也能跟著這套詞匯統一，這事兒是 /grill-with-docs 順手做的

失敗模式 ：代碼就是不 work → 反饋循環

• /tdd ：紅綠重構循環，強制 agent 先寫一個失敗的測試再去修，他在 SKILL.md 里反復強調"測試要測公開行為，不要測實現細節"

• /diagnose ：硬 bug 和性能回歸用的診斷流， Reproduce → Minimise → Hypothesise → Instrument → Fix → Regression-test ，跟一個老工程師手把手帶你 debug 似的

失敗模式 ：代碼變成一坨泥 → 設計意識

• /to-prd ：把當前對話直接整成 PRD 扔成 GitHub issue

• /to-issues ：把一份大計劃拆成可獨立認領的 GitHub issues，垂直切片

• /zoom-out ：讓 agent 站到更高一層抽象上，給你畫一張模塊和調用關系圖

• /improve-codebase-architecture ：定期跑一次，找代碼里"可以更深"的模塊，他建議 每隔幾天跑一次

剩下兩個：

• /triage ：用狀態機的方式分流 issue

• /prototype ：扔一段一次性原型代碼出來回答某個設計問題，要么是終端跑的狀態機，要么是同一個路由下的幾套 UI 變體

• /setup-matt-pocock-skills ：上面提到的初始化腳手架

• /caveman：穴居人模式，砍掉約 75% 的 token 。讓 agent 像聰明的穴居人那樣講話，丟掉冠詞、寒暄、廢話，技術信息一字不動。我看完真的笑出來了，這個想法又野又實用

• ** /grill-me **：上面提過

• /write-a-skill：教 agent 怎么寫一個新的 skill，meta 操作，寫 skill 的 skill

• ** /git-guardrails-claude-code **：給 Claude Code 裝 hook，把 git push --force 、 reset --hard 、 clean 這種危險命令在執行前直接攔掉，老章強烈建議大家把這個裝上，agent 手抖一次代價太大了

• ** /migrate-to-shoehorn **：把測試文件里的 as 類型斷言遷到他自己寫的 @total-typescript/shoehorn ，TS 工程師專屬

• ** /setup-pre-commit **：一鍵搞定 Husky + lint-staged + Prettier + 類型檢查 + 測試的 pre-commit hook

• ** /scaffold-exercises **：批量生成練習題目錄結構，他自己出課用的

老章過一遍后的幾點觀感：

第一，明顯是給 TypeScript / 全棧工程師寫的。migrate-to-shoehorn 直接綁了他自己的 TS 庫，PRD、issue、ADR 那套流程也是典型的 web 后端/全棧打法

第二，"質問 agent"的味道很重。Anthropic 官方 skill 偏向"agent 自動幫你做完"，Matt 這套反過來 —— grill-me / grill-with-docs 都是讓 agent 把你按在椅子上盤問，倒逼你想清楚再動手。這其實更接近資深工程師的真實工作方式

第三，每個 skill 都很短。絕大部分 SKILL.md 是幾百行內的純 markdown，沒有一堆嵌套腳本，改起來心理負擔小。這點跟他在 README 里說的"小、易改、可組合"一脈相承

第四，背后引用的全是經典工程書。Pragmatic Programmer、DDD、XP、A Philosophy of Software Design，他在 README 里逐一搬出來當錨點，這就讓這些 skill 不像很多"prompt 模板"那樣飄在空中，它是真有底子的

老章的真誠評價

先說哪些值得直接抄：

• /grill-with-docs + CONTEXT.md 這套思路含金量最高，跨語言通用，跟 TS 沒關系，建議每個用 Claude Code 的人都試一次

• /diagnose 那個六步循環，可以直接當 debug SOP 用，哪怕不接 agent，自己照著走一遍也能少走彎路

• /git-guardrails-claude-code 是保命用的，強烈建議裝

• /caveman 省錢省到笑

需要注意的：

• 一部分 skill（比如 to-issues 、 to-prd 、 triage ）默認假設你用 GitHub Issues 或 Linear 做項目管理，國內團隊用飛書項目、Tapd、Coding 的需要自己改一下提示詞

• migrate-to-shoehorn 、 scaffold-exercises 這些非 TS / 非課程作者基本用不上，不用糾結

• 倉庫整體是英文 prompt，中文項目里直接用沒問題，但如果你想讓輸出全中文，最好在 /setup-matt-pocock-skills 跑完后再補一句中文寫作約束

總的說，這是目前我見過最像"老工程師私房菜"的一個 skills 倉庫，不像很多 awesome 列表堆數量，每條都能感覺到他在自己項目里反復打磨過

skill 這個生態今年明顯熱起來了，從 Anthropic 官方下場，到 OpenAI 跟進，到現在 Matt Pocock 這種領域大佬把自己 dotfile 直接公開，越來越像當年大家分享 vim 配置、shell rc 的氛圍，值得每一個還在跟 Claude Code / Codex 死磕的人長期跟進