Matt Pocock Skills 教學：安裝與完整開發流程
Matt Pocock Skills 怎麼安裝與使用？本文比較 Claude Code plugin 和 skills.sh，帶你完成專案設定，並實際走過需求訪談、規格、工單、TDD、實作與 code review。
目錄+
把整套 Skills 一次裝滿，不會讓 coding agent 突然變成資深工程師。你真正需要的是一條能驗證的最小流程：先對齊需求，再寫規格、拆工單、測試、實作，最後 review。這篇直接把那條路走完。
最小可用流程，勝過最大的 Skill 清單。
Matt Pocock Skills 如何安裝？
官方現在提供兩條安裝路線。它們的差別不是功能多寡，而是誰負責維護技能檔案。
| 使用情境 | 安裝方式 | 主要取捨 |
|---|---|---|
| Claude Code，希望自動更新 | 官方 Marketplace plugin | 唯讀、由 Marketplace 管理 |
| Codex 或其他 Agent | skills.sh | 複製進專案，可自行修改 |
| Claude Code，但想深度客製 | skills.sh | 自己決定何時更新 |
Claude Code：安裝官方 plugin
在終端機執行：
claude plugins install mattpocock-skills
也可以在 Claude Code session 內輸入：
/plugin install mattpocock-skills
它已進入 Claude Code 官方 Marketplace，不需要先手動加入 marketplace。Plugin 會跟著作者發布的版本更新，但內容是唯讀套件。
Codex 與其他 Agent：使用 skills.sh
npx skills@latest add mattpocock/skills
安裝器會讓你選要拿哪些 Skills，以及安裝到哪個 coding agent。記得包含 setup-matt-pocock-skills。官方 README 目前仍把 native Codex plugin 列在 roadmap，因此 Codex 主要走這條路。
官方安裝文件也特別提醒：plugin 與 skills.sh 選一種就好。兩者一起裝，會得到兩份同名 Skills，反而讓 Agent 不知道該載入哪份。
如果你想了解 Skill 自動偵測的另一種作法，可以先看autoskills 如何依 tech stack 安裝 Skills。
先執行 setup-matt-pocock-skills
安裝完成後，在每個 repository 執行一次：
/setup-matt-pocock-skills
這不是形式上的初始化。它會先探索 repo，再處理三類會影響後續 Skills 的設定；其中有些問題只在符合條件時才會出現：
- 確認 issue tracker 放在哪裡：GitHub、GitLab、local markdown 或其他系統。
- 只有已安裝
triage時，才確認是否沿用ready-for-agent等預設 labels。 - Domain docs 預設採單一
CONTEXT.md；偵測到 monorepo 時，才詢問是否改用多組 context。
設定結果會寫進既有的 CLAUDE.md 或 AGENTS.md，並在 docs/agents/ 保存 issue tracker 與 domain docs 的讀取規則。setup Skill 原始規格要求先展示草稿、取得確認才寫入，不應默默覆蓋專案文件。
用一個小功能走完整流程
下面用「替會員加入 Email 通知偏好」當例子。重點不是這個功能，而是每一階段交付什麼。
1. 先用 grill-with-docs 對齊
/grill-with-docs
Agent 應該先問清楚：「會員」是否等於登入使用者？通知偏好有全域開關還是事件層級？預設值是 opt-in 還是 opt-out？哪些答案是 codebase 裡已存在的事實，應該自己查；哪些是產品決策，必須交給人回答。
對齊過程會更新 domain glossary；遇到難以逆轉、具有真實取捨的長期決策時，才建立 ADR。確認 gate 沒通過前，不進入實作。
2. 用 to-spec 整理已談過的內容
/to-spec
to-spec 不會再重新訪談。它把對話和 codebase 理解整理成 problem、solution、user stories、implementation decisions、testing decisions 與 out of scope，然後發布到已設定的 issue tracker。
其中一個重要步驟是先確認 test seam。以通知偏好為例，seam 可能是「透過公開 API 更新並讀回設定」，而不是直接測某個 private database helper。官方 to-spec 規格要求測試對外行為，不把容易過期的 file path 寫死在 spec。
3. 用 to-tickets 拆成 tracer bullets
/to-tickets
Tracer-bullet ticket 是一條窄但完整的垂直切片。它不是「先完成全部 schema，再完成全部 API，最後才做 UI」，而是每張工單都走過需要的層，完成後可以單獨 demo 或驗證。
例如：
- 建立全域 Email 開關的儲存、API 與最小測試。
- 在設定頁顯示並修改開關；blocked by 1。
- 新增特定事件偏好；blocked by 1。
每張 ticket 都要標出 blocking edges，而且大小要能放進一個新的 Agent context window。to-tickets 的官方定義還會先把拆法交給人確認，再發布到 tracker。
4. 用 implement 和 tdd 完成一張 ticket
/implement
implement 會依 spec 或 tickets 工作，在事先同意的 seam 使用 tdd。每輪只做一個垂直切片：先寫會失敗的行為測試，只加足以通過的實作，再進下一輪。
過程中要固定跑單一 test file 與 typecheck，最後才跑完整 test suite。這些驗證指令必須來自你的 repository，而不是讓 Skill 自己猜。
5. 用 code-review 收尾
implement 完成後會進入 code-review。它把同一份 diff 分成兩條獨立檢查：
- Standards：有沒有違反 repository 明文規範與常見 code smells。
- Spec：有沒有漏需求、做錯需求或增加沒被要求的行為。
兩條軸分開，才能避免「程式碼很漂亮」掩蓋「功能做錯了」。
Claude Code 與 Codex 的使用差異
本文用 slash command 示範，是因為 Claude Code plugin 提供這種直接入口。在 Codex 或其他支援 Agent Skills 的工具裡，這些標成 user-invoked 的核心流程仍要依該工具語法明確指名；只有 model-invoked Skills 才可能由 Agent 依情境自動載入。
| 面向 | Claude Code plugin | Codex／skills.sh |
|---|---|---|
| 發布方式 | Marketplace 管理 | Skill 檔案複製進專案 |
| 更新方式 | 跟隨 plugin 更新 | 執行 npx skills update 或自行維護 |
| 客製方式 | 套件唯讀 | 直接修改 SKILL.md |
| 適合情境 | 想快速跟上作者版本 | 想固定、審查或改寫團隊流程 |
真正需要跨工具共用的，不是某個 slash command，而是相同的 domain language、驗證指令和完成標準。
想看一份 Skill 如何把明確規則封裝成可修改的 Markdown，可以參考Humanizer 如何用 SKILL.md 約束 AI 寫作行為。它的用途不同，但很適合觀察「規則本身就是產品」這件事。
最值得先裝的最小組合
第一次上手，不必把 repo 裡所有 Skill 都帶走。可以從這組開始：
setup-matt-pocock-skills：建立 repository 設定。grill-with-docs：處理需求不清與術語漂移。to-spec：把共識變成可驗收規格。tdd：建立能回饋實作的測試循環。implement：把實作、驗證與 review 串起來。
中型以上任務再加 to-tickets；難以重現的 bug 再加 diagnosing-bugs。先處理你最常失敗的那一段。
常見失敗：裝太多、沒客製、沒有驗證
第一個失敗是 plugin 和 skills.sh 同時安裝，產生重複技能。第二個是跳過 setup，讓 to-spec 和 to-tickets 不知道 issue 該寫去哪裡。第三個是直接照搬作者偏好，卻沒有填入專案自己的 typecheck、test、build 和文件路徑。
還有一個容易忽略的點：Skill 是流程，不是保證。你的測試如果只檢查 implementation details，TDD 仍然會產出脆弱測試；你的 glossary 如果沒人維護，CONTEXT.md 也會變成過期字典。
下一步準備把個人流程交給團隊時，請接著看團隊如何用 CONTEXT.md、ADR 與工單導入 Agent Skills。若還沒讀系列入口，可先補Matt Pocock Skills 是什麼，以及它解決的四個問題。
每天長時間操作 coding agent 的工作環境，可以參考蝦皮開發者桌面四件套整理鍵盤、USB-C Hub、螢幕掛燈與站立書架。這與 Skill 功能無關，只是常見的桌面配置選項。
利益揭露：本文部分連結為聯盟連結；若你透過連結購買，本站可能獲得回饋，不影響你的購買價格。
常見問題
Claude Code 要用哪一條指令安裝 Matt Pocock Skills？
目前官方 Marketplace 可直接執行 claude plugins install mattpocock-skills，或在 Claude Code session 內輸入 /plugin install mattpocock-skills。安裝後，每個 repository 還要執行一次 /setup-matt-pocock-skills。
Codex 可以使用 Matt Pocock Skills 嗎？
可以。執行 npx skills@latest add mattpocock/skills，選擇需要的 Skills 與 Codex；官方目前把原生 Codex plugin 列為 roadmap，所以 Codex 主要走 skills.sh。
Claude Code plugin 和 skills.sh 可以一起安裝嗎？
不要一起安裝。官方明確提醒兩種方式同時使用會讓每個 Skill 出現兩份；想自動更新就選 plugin，想直接修改檔案就選 skills.sh。
setup-matt-pocock-skills 每次開啟 Agent 都要執行嗎？
不用。它是每個 repository 執行一次的設定流程；只有更換 issue tracker、domain docs 位置或想重做設定時，才需要再次執行。
現在不要先研究完整技能清單。挑一項範圍小、已有驗證指令的真實任務，走完對齊、spec、實作與 review，再決定下一個要加入哪個 Skill。