Matt Pocock Skills v1.3 更新：GLOSSARY.md、整份規格實作與升級方式
Matt Pocock Skills v1.3 把 CONTEXT.md 改成 GLOSSARY.md，加入整份規格實作、PR 說明與工作回顧流程。本文整理 Claude Code、Codex 使用者的升級差異，以及自訂技能如何保留。
Matt Pocock Skills 是一套供 AI 程式代理閱讀的工作指引，將需求釐清、寫程式、審查與回顧拆成可組合的技能。v1.3 的重點，是讓代理更清楚理解專案用語，並把整份規格的實作納入同一條工作流程。
2026 年 10 月 5 日查詢時，作者在 X 分享的升級建議已引起超過 11 萬次瀏覽。他建議先比較新舊技能，再看最近的使用紀錄，判斷哪些變化適合自己的專案。這個做法值得保留：技能更新涉及工作方式，更新前先看差異，能避免把團隊累積的規則一起蓋掉。
Matt Pocock Skills v1.3 改了什麼
依官方版本說明，原本記錄領域用語的 CONTEXT.md 與 CONTEXT-MAP.md，改名為 GLOSSARY.md 與 GLOSSARY-MAP.md。Glossary 就是詞彙表，讓代理知道專案中的「課程」「訂單」或「實體化」各自代表什麼。
新版技能往後會尋找新檔名。沿用舊檔名的專案需要搬移檔案，並檢查其他文件是否仍指向舊路徑。只有改好名稱卻留下失效的文件引用，代理仍可能讀不到重要背景。
新版也把 implement-spec、pr 和 retro 納入工程技能。前者依任務之間的依賴關係處理整份規格，pr 協助寫清楚變更與驗證證據，retro 則回顧代理的工作環境，找出可以改善的文件、檢查或工具安排。
整份規格實作，先把需求寫到能驗收
implement-spec 可以讓子代理分頭實作已準備好的任務。子代理是由主代理分派的小型工作者，各自在分開的程式副本裡完成工作，最後整合到同一個分支。
這能降低逐張工單手動啟動的負擔，但前提是規格已寫清楚。像「讓結帳更順」這類需求仍缺少完成標準。若改成「付款失敗後保留購物車，並顯示可重試的錯誤訊息」，代理才有可檢查的行為。
版本說明也把最終交付重心放在整合分支。建立拉取請求，也就是供團隊審查的程式變更提案，要依專案的工單流程或使用者要求處理。這讓技能能配合既有工作方式。
Claude Code 和 Codex 的安裝方式怎麼選
官方 README 提供套件式安裝與可編輯檔案兩種方式。Claude Code 外掛適合希望跟著作者更新的人，可編輯技能檔案則適合需要改成團隊版本的使用者。
| 使用方式 | 適合情境 | 更新時要留意 |
|---|---|---|
| Claude Code 外掛 | 希望使用整套維護中的技能 | 更新後檢查工作流程變化 |
| 複製技能檔案 | 需要改寫專案規則 | 比較本地修改與上游差異 |
| 只選部分技能 | 已有自己的工程流程 | 確認被引用的技能也存在 |
同時裝入兩套內容，可能讓代理看到重複技能。選擇一個主要來源，通常更容易追蹤哪個版本正在生效。
升級前，先保留專案自己的知識
實用的升級方式是先保存現有檔案，再比較新增、刪除與改名的內容。GLOSSARY.md 應保留團隊自己的名詞定義，不能用通用範本取代。技能中的文件位置、工單標籤與檢查命令，也要和專案實際環境一致。
作者建議檢視最近 25 次工作紀錄，能幫助判斷哪些技能常用。但工作紀錄可能包含客戶或內部資料，分析時應限定範圍，保留有助於改善流程的資訊即可。
我的判斷是，v1.3 值得已有固定代理工作流程的開發者評估。它改善的是需求、文件與驗收之間的銜接。若專案尚未建立基本檢查，先補上這些基礎，再增加技能數量會更有效。
常見問題
GLOSSARY.md 是模型的永久記憶嗎？
它是專案裡的文件，代理讀取後才會得到相關背景。檔名改好不代表模型已經理解內容，定義仍要清楚且符合實際程式。
更新後需要重寫所有技能嗎？
不需要。先處理檔名與被引用的路徑，再比較影響現有流程的變化。團隊自行修改的部分可以保留。
新手應該一次安裝全部嗎？
可以先從需求釐清與程式審查開始，熟悉後再加入整份規格實作。技能應解決正在遇到的問題。
結語：讓技能跟著專案成長
Matt Pocock Skills v1.3 提供了更完整的工程流程，但使用者仍要決定規格、整合與驗收方式。從一個小功能試用，觀察代理是否更容易讀懂用語、交出可檢查的成果，再把有效的規則留進專案，會比一次加入大量指引更容易維護。
