mattpocock/skills 是什麼、怎麼安裝：Matt Pocock 的工程師 Skills（grill-me、tdd、to-spec）

本文根據 mattpocock/skills 倉庫 README 和 skills.sh 榜單整理，資料核對於 2026-10-10。技能增減頻繁，以倉庫 README 為準。

是什麼

Matt Pocock 是知名的 TypeScript 講師（Total TypeScript、AI Hero 的作者）。這個倉庫是他自己每天在用的智能體技能，口號是「給真正做工程的人，而不是憑感覺寫代碼」。README 裏他的立場很明確：一些大而全的流程框架接管了整個過程，出了問題反而難排查；所以他的技能刻意做得小、容易改、可以互相組合，不綁定某個模型。

他把技能對應到用智能體寫代碼時最常見的四種失敗：智能體沒做你想要的（用追問來對齊）、智能體太囉嗦（建立項目術語表）、代碼跑不通（測試驅動和調試循環）、越寫越亂（關注模組設計）。

截至 2026-10-10，GitHub 顯示該倉庫約 28.3 萬 Star、2.4 萬 Fork，最近一次推送在 2026-10-09。在 skills.sh 的總榜上（2026-10-10），它的 grill-me、grill-with-docs、tdd、improve-codebase-architecture 等多個技能都在前十，安裝量各約 110 萬至 130 萬次。

包含哪些 Skill

技能分工程（engineering）和效率（productivity）兩組，又分「只能由你輸入觸發」和「模型也可以自動調用」兩類。常用的有：

• 對齊需求：grill-me（圍繞一個計劃不停追問，直到每個分支都有答案）、grill-with-docs（追問的同時整理項目術語表 GLOSSARY.md 和架構決策記錄）；
• 從討論到任務：to-spec（把當前對話整理成規格並發到 issue 系統）、to-tickets（拆成有依賴關係的小任務）、wayfinder（一次會話裝不下的大工程，拆成決策清單逐個解決）；
• 實現：implement（按規格實現，中途調用 tdd，最後做代碼評審）、tdd（紅綠重構，一次一個縱向切片）、prototype（做用完即棄的原型回答設計問題）；
• 質素：diagnosing-bugs（搭一個能復現問題的反饋迴路再逐步定位）、code-review（按規範和按規格兩條線並行評審）、improve-codebase-architecture（掃描代碼庫找可以加深的模組，給出候選）、codebase-design、domain-modeling；
• 協作：triage（給 issue 分流）、pr（PR 描述該寫成什麼樣）、handoff（把當前對話壓縮成交接文檔）、retro（會話結束後建議怎麼改進智能體的工作環境）；
• 通用：teach（跨多次會話教你一個新概念）、wait-what（沒看懂時讓它換個說法）、ask-matt（不知道該用哪個技能時問它）。

怎麼安裝

README 提醒：插件方式會自動更新，npx skills 方式是把可編輯的文件複製進項目、需要手動更新，每種智能體只選一種，否則每個技能會出現兩份。命令均來自 README。

bash
# Claude Code
claude plugin install mattpocock-skills@claude-plugins-official

# Codex
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

# GitHub Copilot CLI
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock

# Gemini CLI（手動更新）
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity

# 其他智能體，或想要可編輯的文件
npx skills@latest add mattpocock/skills -a <agent>

最後一種方式裏 <agent> 可以是 cursor、opencode、windsurf、amp 等，安裝器詢問時記得勾選 setup-matt-pocock-skills。

裝完後每個倉庫運行一次 /setup-matt-pocock-skills：它會問你用哪種 issue 系統（GitHub、GitLab、本地文件等）、分流時用什麼標籤、文檔存在哪裏。README 沒有提供 claude.ai 網頁版的安裝方式。

怎麼用

• 改動之前先對齊：輸入 /grill-with-docs，再說你想做的改動。它會像面試一樣逐條追問邊界和取捨，同時把項目裏的專有名詞記進術語表。作者建議每次動手前都用一次。
• 按測試驅動實現：對齊之後輸入 /to-spec 生成規格，再用 /implement；它會在約定好的位置調用 tdd，先寫失敗的測試再寫實現，收尾時自動做一次 code-review。
• 定期體檢：每隔幾天運行 /improve-codebase-architecture，它會生成一份 HTML 報告列出值得重構的模組，你挑一個再深入討論。README 強調它是「勘察」而不是「救援」，不會替你把爛代碼一次理順。

適合誰 / 不適合誰

適合：

• 有一定工程經驗、想保留對流程的控制、只在關鍵環節藉助技能的開發者；
• 重視需求對齊、測試和模組設計的團隊；
• 想把技能改成自己風格的人——這些技能短小，容易讀懂和修改。

不適合：

• 想要「裝上就全自動」的一體化流程的人——那更像 Superpowers 的定位；
• 不用 issue 系統、不寫測試的小型腳本項目；
• 編程新手：技能預設你理解 TDD、領域建模、ADR 這些概念。

注意事項

• 許可證：MIT。
• 維護狀態：非常活躍（最近推送 2026-10-09）；技能名稱和約定時有調整（例如術語表文件曾經叫 CONTEXT.md，現在是 GLOSSARY.md），舊教學裏的命令可能已改名。
• 會寫入外部系統：to-spec、to-tickets、triage 等會在你的 issue 系統裏創建或修改內容，首次使用先在測試倉庫試一下，並確認智能體拿到的令牌權限。
• 不要重複安裝：插件和 npx skills 兩種方式同時裝會出現重複技能。
• 安全：來源知名；但技能能執行命令、讀寫倉庫文件，裝進團隊倉庫前仍建議過一遍 SKILL.md。skills.sh 的審計頁對其中個別技能給出過「中等風險」評級，可以作為參考。