內容摘要

Skills For Real Engineers 是 Matt Pocock 面向專業工程師推出的 AI Agent 技能庫,來自在 .claude 目錄中每天使用的實務集合。它不是 GSD、BMAD 那樣的重型流程框架,而是一組小而美、可組合、可自由改造的技能,用 /grill-me、/tdd、/diagnose 等指令在編碼前對齊需求、驅動紅綠重構、標準化排查缺陷,而且不綁定特定模型。

Skills For Real Engineers 完整指南:Matt Pocock 的 AI Agent 技能庫 screenshot

Skills For Real Engineers 是什麼

一句話答案:Skills For Real Engineers(儲存庫名稱為 Matt Pocock Skills)是 Matt Pocock 推出的、面向專業工程師的 AI Agent 技能庫,源自 Matt Pocock 日常 .claude 目錄實務。

它的定位很清楚——不是 vibe coding 的玩具,而是「真正做工程」的日常工具箱。作者自述,這些技能是為了修復他在 Claude Code、Codex 等編碼 Agent 上反覆遇到的常見失敗模式。

與 GSD、BMAD 的差別

GSD、BMAD、Spec-Kit 這類方法試圖「接管流程」。但接管流程的同時,也拿走了你的控制權,流程一旦出問題就很難定位。Skills For Real Engineers 走的是相反路線:

  • 小而美:每個技能獨立可用,不做大一統框架。
  • 可組合:按需挑選、自由裁剪,配合自己的儲存庫。
  • 可 hack:技能就是你儲存庫裡的普通檔案,看不懂就改。
  • 模型無關:不綁定特定模型,Claude、Codex、Cursor 等均可使用。
  • 工程原生:以《The Pragmatic Programmer》《Domain-Driven Design》等經典工程原則為基礎,而不是堆疊 prompt 技巧。

產品定位

面向已有真實工程習慣的開發者:用靜態型別、自動化測試、紅綠重構等真實回饋約束 Agent,避免它「盲目飛行」。技能庫本身不提供代管服務,也不替你決定架構,只提供一套可重複使用的對話與流程介面。

核心功能

技能以斜線指令的形式提供給 Agent,大致分為以下幾組。

需求對齊

  • /grill-me:透過高強度追問對話,在編碼前徹底對齊需求與決策分支,非編碼場景也能用。
  • /grill-with-docs:在 grilling 的基礎上,與 Agent 共建專案共享語言與架構決策記錄(ADR)。
  • /zoom-out:要求 Agent 跳出局部程式碼,從系統整體視角給出解釋。

開發與驗證

  • /tdd:驅動 Agent 執行紅綠重構循環,以垂直切片方式逐次建置功能或修復缺陷。
  • /diagnose:標準化的診斷閉環——重現→最小化→假設→插樁→修復→回歸測試。
  • /prototype:快速建置可執行的終端機原型或多種 UI 變體,用於驗證設計。

任務與規劃

  • /triage:以狀態機對 Issue 分級分派,支援自訂標籤詞彙。
  • /to-prd:將目前對話上下文自動合成為 PRD,並提交為 GitHub Issue。
  • /to-issues:把計畫或 PRD 拆分為可獨立認領的垂直切片任務。

架構與協作

  • /improve-codebase-architecture:依據 CONTEXT.md 與 ADR 找出模組深化機會,治理架構泥球。
  • /caveman:極致壓縮溝通模式,在維持技術精確度的前提下削減約 75% 的 token 消耗。
  • /handoff:將目前對話壓縮為交接文件,方便其他 Agent 無縫接續。
  • /teach:以目前目錄作為具狀態的教學空間,跨多個工作階段傳授新技能或概念。
  • /write-a-skill:依規範結構建立新技能,支援漸進式揭露與資源打包。

共享語言機制

透過 CONTEXT.md 建立專案術語體系,是這套技能裡最被作者看重的一招。作者觀察到的現象是:Agent 通常被直接丟進專案裡,邊做邊猜專業行話,於是本來 1 個詞就能講清楚的事,它要用 20 個詞來表達。

舉例來說,把「課程某個 section 裡的 lesson 被 made real」改寫為「materialization cascade 出問題了」,一句話就能省下大量解釋成本,而且這種精簡會隨對話一次次累積複利。共享語言還會帶來:變數、函式、檔案命名一致;程式碼庫對 Agent 更好導覽;Agent 思考時消耗的 token 更少。

如何使用 Skills For Real Engineers

有兩條進入路徑,對應兩種哲學,只能選一個。

路徑一:Claude Code 外掛

  • 整套技能以受管理的唯讀套件形式安裝,作者釋出新版時自動更新,相當於「訂閱」而非 fork。
  • 它已收錄在 Claude Code 官方市集中,無需先新增來源,更新會自動送達。
  • 原生 Codex 外掛仍在路線圖中(見 .agents/adr/0002-ship-as-a-claude-code-plugin.md)。

路徑二:skills 安裝器

執行 npx skills@latest add mattpocock/skills,選擇目標 Agent 並勾選 /setup-matt-pocock-skills。安裝器讓你自己挑技能、挑要裝到哪些編碼 Agent 上;技能會以一般檔案寫進你的儲存庫,由你擁有、可編輯,不會在背後自動更新;想更新時,用 npx skills update 拉取最新改動。

注意:兩條路徑同時安裝,會讓每個技能出現兩份。

初始化與日常節奏

  1. 在 Agent 中執行一次 /setup-matt-pocock-skills,每個儲存庫只需要執行一次。它會問你:要用哪個 Issue 追蹤器(GitHub、Linear 或本機檔案);triage 時要打什麼標籤(/triage 依賴這些標籤);產生的文件要存到哪個目錄。
  2. 每次變更前,用 /grill-me 或 /grill-with-docs 對齊需求。
  3. 開發過程中使用 /tdd 保障品質。
  4. 遇到 bug 用 /diagnose 啟動標準化診斷流程。
  5. 架構維護上,定期執行 /improve-codebase-architecture 防止程式碼腐化。

整套安裝與設定約 30 秒即可完成,支援 GitHub、Linear 或本機檔案作為 Issue 追蹤器。

適用場景

  • 需求對齊與規劃:專案啟動或功能變更前,透過 /grill-me 或 /grill-with-docs 與 Agent 高強度追問,確保雙方對需求、決策分支與領域術語完全對齊。
  • 測試驅動開發:需要保證程式碼品質時,用 /tdd 驅動 Agent 執行紅綠重構循環,以垂直切片逐次建置功能或修復缺陷,讓每次變更都有自動化測試守護。
  • 複雜 Bug 診斷:遇到難以重現的效能衰退或邏輯缺陷時,用 /diagnose 走完整診斷閉環。
  • 架構持續治理:在大型、長期維護的程式碼庫中定期執行 /improve-codebase-architecture,依據 CONTEXT.md 與 ADR 找出模組深化機會,避免 Agent 加速程式碼腐化。
  • 跨工作階段協作:用 /handoff 壓縮對話、用 /caveman 壓降 token,適合長任務與多人、多 Agent 接力。

優點

  • 輕量可組合:拒絕重型框架,每個技能獨立可用,可自由裁剪調整。
  • 模型無關:Claude、Codex、Cursor 等均可使用。
  • 工程原生:建立在經典工程原則之上,而非 prompt 技巧。
  • 共享語言機制:CONTEXT.md 能顯著降低 Agent 的溝通成本與 token 消耗。
  • 回饋閉環:強調靜態型別、自動化測試、紅綠重構等真實回饋。
  • 易於改造:skills 路徑下,技能就是你儲存庫裡可編輯的檔案。

局限

  • 它是一組技能,不是端到端的流程管理器;沒有共享語言、ADR 紀律的團隊,需要自行維護 CONTEXT.md 與決策記錄。
  • /triage 的標籤體系依賴初始化時的設定,設定不當會影響分級效果。
  • 兩條安裝路徑互斥,同時安裝會讓技能重複出現。
  • 原生 Codex 外掛仍在路線圖中,Codex 使用者目前走技能檔案安裝路徑。
  • 具體支援範圍、指令細節與更新節奏可能隨版本調整。

價格與可用性核對提醒

本次資料未提供任何價格、訂閱費用或授權條款資訊,因此不做揣測。是否收費、授權方式、可用的安裝管道與最新版本狀態,請直接到產品官網 https://github.com/mattpocock/skills 及你所使用的 Agent 官方外掛市集頁面核對後再做決定。

常見問題(FAQ)

它會綁定某個模型嗎?

不會。官方說法是模型無關,Claude、Codex、Cursor 等均可使用。

裝完就能直接用了嗎?

還需要初始化。請在 Agent 中執行一次 /setup-matt-pocock-skills,設定 Issue 追蹤器、分級標籤與文件目錄,之後 /triage 等技能才會按照你的約定運作。

我該選外掛還是安裝器?

想跟著作者更新、接受受管理的唯讀套件,就選 Claude Code 外掛;想擁有並改造檔案、自己控制更新時機,就用 npx skills@latest add mattpocock/skills。兩者不要同時安裝。

它和 GSD、BMAD 衝突嗎?

作者的設計意圖是提供替代思路:GSD、BMAD、Spec-Kit 透過接管流程來提供幫助,但也因此收走了控制權,還讓流程內的問題難以解決;這套技能則選擇小而美、可組合、可 hack。是否混用,取決於你的團隊紀律。

最值得先試的是哪個技能?

作者認為 /grill-with-docs 可能是整個儲存庫裡最強的技巧:它既是追問對話,又幫你與 AI 共建共享語言,並把難以解釋的決策寫進 ADR。

替代方案

  • GSD、BMAD、Spec-Kit:試圖接管開發流程的重型框架,控制權更少,流程問題更難定位。
  • 一澤 Eze 開源的 Agent Skill:聚焦「思考如何上網」。
  • Jesse Vincent 開源的 Agentic 技能框架與軟體開發方法外掛。
  • 專為 AI 編碼助手設計的開源 AI 設計 Skill。
  • 通用做法:自己維護一套 .claude 或專案層級的技能檔案,按團隊習慣組合。

一手資料

  • 產品官網與儲存庫:https://github.com/mattpocock/skills

如果你想追蹤這套技能的更新,以及作者新創作的技能,可以訂閱他的 newsletter(目前約有 60,000 名開發者訂閱)。

常見問題

Skills For Real Engineers 會不會綁定某個模型?

不會。它的官方說法是模型無關,Claude、Codex、Cursor 等均可使用。

安裝完就能直接用嗎?還需要做什麼設定?

還需要初始化。請在 Agent 中執行一次 /setup-matt-pocock-skills,它會詢問要使用哪個 Issue 追蹤器(GitHub、Linear 或本機檔案)、triage 時使用什麼標籤、以及文件存放目錄;完成後 /triage 等技能才會按照你的約定運作。

Claude Code 外掛和 skills 安裝器該選哪個?

兩者對應兩種哲學,只能選一個。Claude Code 外掛把整套技能作為受管理的唯讀套件安裝,作者釋出新版時自動更新;skills 安裝器(npx skills@latest add mattpocock/skills)把可編輯的技能檔案複製進你的儲存庫,由你掌控,並可用 npx skills update 拉取更新。同時安裝會讓每個技能出現兩份。

它和 GSD、BMAD 有什麼差別?

GSD、BMAD、Spec-Kit 透過接管流程來提供幫助,但也因此拿走了你的控制權,使流程中的問題難以解決。這套技能堅持小而美、可組合、可 hack,不綁定流程,每個技能獨立可用。

為什麼共享語言被認為這麼重要?

作者觀察到,Agent 常被直接丟進專案、邊做邊猜術語,本來 1 個詞能說清楚的事,它要用 20 個詞表達;用 CONTEXT.md 建立共享語言後,命名更一致、程式碼庫更好導覽、Agent 思考也更省 token,這種精簡會隨對話持續複利。

如果只先試一個技能,推薦哪個?

作者認為 /grill-with-docs 可能是整個儲存庫裡最強的技巧:它既是高強度追問對話,又幫你與 AI 共建專案共享語言,並把難以解釋的決策記錄進 ADR。