跳到主內容
TechSpecs搜尋

Theme / v1.3.2

Matt Pocock's Engineering Skills

可組合的 AI 工程工作流技能庫

主題首頁GitHub ↗
基礎觀念

v1.3.0～v1.3.1：implement-spec／pr／retro 畢業與 GLOSSARY 更名

🟡 中階｜v1.2.3 → v1.3.1 的升級重點：三個 skills 畢業進 Engineering bucket（implement-spec 的 task graph 平行實作、pr 的 PR body 形狀、retro 的環境回顧）、移除 resolving-merge-conflicts、CONTEXT.md 更名 GLOSSARY.md，以及跨 skill 呼叫慣例修正。含互動測驗與升級檢查清單。

概述

Matt Pocock’s Skills v1.3.0 與 v1.3.1 於 2026-10-04 相隔 56 秒連發（v1.3.1 僅多一條 patch）。這是個「重整生態系」的版本：

  1. 三個 skills 畢業：implement-spec、pr、retro 進入 Engineering bucket——進駐 Claude Code plugin、取得 docs 頁面、並由 ask-matt 路由。
  2. 一進一出：resolving-merge-conflicts 被移除——agent 不再需要專屬 skill 就能走完 merge/rebase conflict。
  3. 文件慣例更名：CONTEXT.md／CONTEXT-MAP.md → GLOSSARY.md／GLOSSARY-MAP.md。

一、implement-spec：整份 spec 一次實作

implement-spec（user-invoked）在 v1.3.0 畢業，定位為 per-ticket implement 的平行替代方案。它的工作方式：

  1. 把 tickets 讀成 task graph（任務圖）
  2. 找出 ready 的 frontier（無未完成依賴的任務集合）
  3. 為每個任務開獨立 worktree，跑 implementer subagents 平行實作
  4. 全部落在同一條 integration branch
  5. 收尾跑 code-review

畢業前的三個關鍵調整（release notes 原文意旨）：

  • 目標是 integration branch，不是 PR——draft PR 只在 issue tracker 以 PR 關閉工作、或使用者要求時才開，而且要等第一次 merge 之後（沒有領先 main commits 的分支開不了 PR）
  • 不默認 gh——與兄弟 skills 一樣指向 issue tracker 設定，沒設定時提示執行 /setup-matt-pocock-skills
  • 保證 fast-forward——每個 implementer 回報 done 之前，先把 integration branch 的 tip merge 進自己的分支

二、pr：PR body 應該長什麼樣

pr（model-invoked）定義 pull request body 的形狀：

  • Summary：讓變更一看就懂的最小視覺——pseudocode、call tree、file tree、Mermaid 或 diff（改編自 Dex Horthy 的 show-me，CREDITS.md 有致謝）
  • Before/after 證據：它真的能動
  • Merge-danger 判斷：one-way 或 two-way door，加上 blast radius

三、retro：回顧 session，改善 agent 環境

retro（user-invoked）作為主流程的最後一步（code-review 之後）。它回顧一個 coding session，但建議改的是agent 的環境而非程式碼：

  • navigation pointers、自動化檢查、coding standards、steering files、tool economy、資訊取用

其中 coding-standards 的發現先分類：機械性違規配 deterministic check（linter rule、pre-commit hook 或 CI job）；CODING_STANDARDS.md 只留真正的 judgement calls。release notes 明言：「A repo with no guardrail at all is a finding in its own right.」

四、移除與更名

  • 移除 resolving-merge-conflicts：不再需要、無替代——agent 沒有專屬 skill 也能處理進行中的 merge/rebase conflict。它離開 Claude Code plugin、README 與 ask-matt router。
  • CONTEXT.md → GLOSSARY.md：領域文件慣例全面更名（含 CONTEXT-MAP.md → GLOSSARY-MAP.md），涉及 11 個 skills 與 docs。既有的 CONTEXT.md 需要 git mv 更名——skills 之後只認新名。
  • wait-what 升級：當 repo 以 GLOSSARY-MAP.md 索引多個 context 時，能循線找到正確的 GLOSSARY.md（#904）。
隨堂測驗

你的專案有舊版產生的 `CONTEXT.md`。升級到 v1.3.1 後 skills 讀不到領域詞彙，該怎麼辦？

💡 想先看個提示？

release notes 直接給了遷移指令。

五、跨 skill 呼叫慣例（#878 / #880）

v1.3.0 修了兩個互相關聯的系統性問題：

1. 在 prose 裡點名 skill 不可靠。grill-with-docs 最被回報的問題背後：寫「run the /grilling skill」不保證 skill 被載入。修正為明確寫 Call the Skill tool with "grilling"——直接點名工具以提高命中率，去掉前綴 / 則讓指令 harness 中立。一個步驟需要多個 skills 時寫成多次呼叫。

2. 違反 user-invoked 不變量。五個 skills（to-spec、wayfinder、to-tickets、triage、code-review）原本指示 agent 呼叫 user-invoked 的 setup-matt-pocock-skills——但沒有任何 skill 能呼叫 user-invoked skill。改寫為「告訴人類去執行」。diagnosing-bugs 對 improve-codebase-architecture 的 post-mortem hand-off 同樣違規且實務上極少觸發——直接移除，Phase 6 只剩 Cleanup。

六、其他修復

  • YAML 修復（#911）：六個 skills（to-spec、code-review、setup-matt-pocock-skills、writing-fragments、writing-shape、wait-what）的 description frontmatter 有未加引號的 colon-space，整塊成為無效 YAML——skills.sh discovery 跳過全部六個，npx skills 列不出也裝不了。已加引號修復
  • Em-dash 清除（#905 等）：全 repo 散文手寫改句移除 em-dash（非機械替換），CLAUDE.md/AGENTS.md 加註不得再引入
  • domain-modeling 觸發擴充（#848）：討論 codebase 術語、或直接編輯 GLOSSARY.md／ADR 時觸發
  • v1.3.1（#1121）：ask-matt 不再宣稱 diagnosing-bugs 有 post-mortem hand-off——修復後指向 /retro（問「什麼能預防這個 bug」），缺少 seam 的 finding 指向 /improve-codebase-architecture

隨堂總結測驗

隨堂測驗

v1.3.0 之後，一個 skill 的步驟需要用到 model-invoked 的 `grilling` 與 `domain-modeling`，正確的寫法是？

💡 想先看個提示？

「多次呼叫」與「一次帶兩個名字」是不同選項。

動手升級檢查清單

升級 v1.3.1：動手檢查清單

逐項勾選，確認你已完成升級必要的步驟（進度會保存在此瀏覽器）

0 / 5

v1.3.2 增補：跨 skills 的 patch 修補

v1.3.2（2026-10-29 發布）全數為 Patch Changes——不新增也不移除 skills，主題是「讓既有行為更誠實」：

  • 先查證再陳述：ask-matt 陳述某 skill 做什麼、或建議跳過某步驟前，先讀該 skill 的 SKILL.md，不再只信一行摘要（#1194，修 #614）。code-review 搜尋 repo 的 standards 檔案、固定把 CODING_STANDARDS.md／CONTRIBUTING.md 交給 Standards sub-agent（#1208），兩個 sub-agent 改在前景執行並採用回傳報告。
  • chief-of-staff 記憶改為 LLM wiki（#1304）：index.md 加每個主題一頁，以歷史紀錄方式書寫——每個主張標日期、關於程式碼的主張引用其為真的 commit。
  • subagent 用 fresh context window（#1341）：八個會 dispatch subagents 的 skills（implement-spec、code-review、codebase-design、improve-codebase-architecture、wayfinder、research、grilling、chief-of-staff）明確要求 fresh context window 而非 fork 當前對話——部分 harness（Codex）預設 fork，會丟掉 subagent 存在所為的乾淨 context。這延續了 #878 的跨 skill 呼叫慣例主題。
  • diagnosing-bugs 防假 red（#1209）：Phase 5 在相信 red 前，先對 pristine copy diff 強制突變——靜默沒改到東西的編輯不能冒充失敗測試。
  • seam 選擇有依據（#1192）：tdd 為每個提議 seam 加一行說明它抓得到什麼、抓不到什麼。

延伸閱讀