mattpocock/skills · 使用說明書 Matt Pocock 的 Claude Code 工程師技能集：15 條可部署的工程師 SOP，直接從 .claude 目錄取用。

含 cold-outreach（PAS / AIDA / BAB 直效文案框架）、unit-economics（CAC / LTV 分析）、offer-creation（Hormozi「無法拒絕的報價」法）、sop-builder，作者持續在自己公司每天使用。

涵蓋銷售、業務營運、工程、顧問與 AI 代理架構。能同時啟動數十個獨立代理，每個擁有獨立 1M token context window，適合大規模重構、網站稽核、批量內容產出。

Lead Research Assistant 為銷售、業務開發、行銷人員設計：分析產品 → 搜尋目標公司 → 提供具體外拓策略。可在產品原始碼目錄執行，讓 Claude 從 code 本身推論目標客戶。

收錄 Anthropic、Google Labs、Vercel、Stripe、Cloudflare、Netlify、Figma 等官方技能與社群技能，兼容 Claude Code、Codex、Antigravity、Gemini CLI、Cursor、GitHub Copilot、OpenCode、Windsurf。找銷售類技能從這裡入口最快。

觸發 /tdd，Claude 會強制走一輪 red → green → refactor：先寫紅燈測試、再寫最小通過程式、再重構。對於 AI 容易一次生 200 行錯誤程式的傾向，這條 skill 是強效煞車器。功能或修 bug 都適用。

觸發 /diagnose，Claude 會走一輪「重現 → 最小化 → 假設 → 加儀器 → 修復」的硬 bug 與效能回退診斷流程。對於那種「跑五次成功一次失敗」的飄忽 bug，這條 skill 強迫先驗證假設，避免 AI 用「我覺得應該是」就改錯。

觸發 /grill-with-docs，會把計畫對齊到 codebase 的領域語言與既有 架構決策紀錄（ADR），並在達成共識後自動更新文件。是維持中大型 codebase 「一致性與時間流」的關鍵 skill。

/to-prd 把對話脈絡濃縮成 PRD 並開成一張 GitHub issue；/to-issues 把 PRD 拆成可被獨立認領的 vertical-slice issues。對於「對話討論完一定會走失」的團隊，這兩條是把口頭共識變成可被追蹤工作項的橋樑。

觸發 /caveman，Claude 切換到緊湊輸出模式：移除禮貌語、過渡詞與解釋性段落，只保留動作與技術細節。在長 session 末段 token 預算吃緊時使用，可將有效對話輪次延長 3–4 倍。

安裝完成後，第一步是觸發 /setup-matt-pocock-skills。它會在當前 repo 建立標準的 issue 標籤集合（triage 狀態）、ADR 資料夾、領域文件腳手架。後續其他 skill 依賴這些檔案存在。若跳過此步驟，多條 skill 將無法正常執行。

技能集設計時鎖定 Claude Code 的 skill 規格與 slash command 機制。執行環境需要 Node 20+ 來跑 npx skills CLI。雖然技術上 markdown 內容可以拷貝到 Cursor / Codex，但 trigger 與工序對齊需要 Claude Code。

engineering/ 是工序硬核（diagnose、tdd、grill-with-docs、to-prd 等 9 條）；productivity/ 是日常加速（caveman、grill-me、write-a-skill）；misc/ 是雜項工具（git-guardrails、setup-pre-commit、scaffold-exercises 等）。deprecated/ 留作歷史檔，請忽略。

這條 skill 在設定層級攔截危險 git 指令：當 Claude 嘗試執行會破壞 git 歷史的指令時，要求人工確認。適用於 yolo 模式或 agent 自動執行的工作流，防止單次失誤毀損整條 branch。

/setup-pre-commit 會在 repo 安裝並設定 Husky + lint-staged，把 type-check、lint、format 拉到 commit 之前。配合 git-guardrails 與 tdd 使用，形成「本地三道線」的品質防護網。

先觸發 /grill-me 把計畫對齊到位；確認後直接接 /tdd 進入 red-green-refactor。對於不確定 AI 會怎麼解讀需求的功能，這條鏈幾乎可以把 rework 機率降到零。建議在 CLAUDE.md 把這條鏈寫成標準工序。

觸發 /improve-codebase-architecture，Claude 會依領域語言與 ADR 找出可被深化、抽出邊界、補強模型的機會點。建議在每個 sprint 結束時跑一次，把結果濃縮成 2–3 個 ADR 候選，下個 sprint 排進去。

當你看到 Claude 在某個 file 裡來回打轉、改了一堆細節但效果不好，先 stop，觸發 /zoom-out。它會請 Claude 退回去看更大的脈絡（檔案、模組、領域），重新評估方向。比硬塞更多 prompt 有效十倍。

觸發 /triage，Claude 會依設好的 triage 狀態機檢視 issue，給每張 issue 套上對應 label，並提示需要哪些補件。對於 issue 累積到三位數的 repo，這條 skill 把治理從「一週一次大會」變成「每天 5 分鐘」。

觸發 /write-a-skill，會帶你建立一個結構正確（progressive disclosure、bundled resources）的新 skill。把公司既有 SOP（code review checklist、PR 模板、release runbook）轉成 skill，從這條開始最快。

把 npx skills@latest add mattpocock/skills 寫進團隊 onboarding doc，並在每月第一個 Monday 安排一次更新。skills CLI 會 diff 既有 .claude/skills 與 upstream，提示哪些檔案被改、哪些是新檔案，避免覆蓋自己的客製。

/migrate-to-shoehorn 把測試中的 as Foo 等 type assertions 改寫成 shoehorn 風格的 helper，讓型別錯誤被編譯器抓出來而不是在 runtime 爆炸。對於正在從 Jest / Vitest 大型測試庫遷移到嚴格模式的團隊特別有用。

開新專案時：先 /grill-with-docs 把模糊願景磨成清楚架構決策；再 /to-prd 把對話寫成 PRD；最後 /to-issues 把 PRD 切成 vertical-slice issues。三條 skills 接力，從點子到可被認領工作，一個下午就完成。

線上問題、heisenbug、效能回退等找不到根因的 bug，從 /diagnose 開始。流程強制先重現、最小化、提出假設、加儀器、再修復。對於已反覆修改多輪仍未解決的 bug，此 skill 有助在第一輪就縮小根因範圍。

新人加入時，將 /zoom-out 排入第一週流程：每天選一個模組，讓 Claude 說明設計動機、領域邊界與依賴方向。可作為閱讀 doc 與詢問 senior 之外的補充途徑，適合 5 人以上的工程團隊。

不適合的情境：(1) 完全不審稿的「make it work」單向使用，本技能集假設人工負責審稿；(2) 非 Claude Code 環境，Cursor / Codex 雖可讀取 skill 內容，但 trigger 機制不相容；(3) 沒有 GitHub 的封閉系統，to-prd / to-issues / triage 均依賴 GitHub issue API；(4) 不採用 TDD 的團隊，/tdd 是本技能集的硬性前提。