跳到主內容
TechSpecs搜尋

Theme / v1.3.2

Matt Pocock's Engineering Skills

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

主題首頁GitHub ↗

Changelog

版本更新紀錄

收錄 Matt Pocock's Engineering Skills 的版本變遷軌跡。每條紀錄以舊值→新值呈現，舊值以紅線劃掉但保留可見，方便對照改動軌跡。

當前記錄版本

v1.3.2

查看上游所有 Release ↗

  1. v1.3.2

    已同步2026-10-30
    • 2026-11-06 查核：上游最新 release 仍為 v1.3.2（2026-10-29 發布），其後無新版本。
    • 版本定位：v1.3.1→v1.3.2，2026-10-29 發布，全數為 Patch Changes，不新增也不移除 skills；修正橫跨 ask-matt、chief-of-staff、code-review、diagnosing-bugs、grilling、handoff、implement、tdd、teach、to-tickets、wayfinder、wizard 與 setup 寫出的 GitHub／GitLab 模板。
    • agent 先查證再陳述：ask-matt 在陳述某 skill 做什麼、或建議跳過某步驟前，先讀該 skill 的 SKILL.md，不再只信自己的一行摘要（#1194，修 #614）；code-review 搜尋 repo 內的 standards 檔案，固定把 CODING_STANDARDS.md／CONTRIBUTING.md 交給 Standards sub-agent（#1208，修 #1065），兩個 sub-agent 在前景執行並採用其回傳報告（修 #1073），issue tracker 透過提供的 tracker 文件解析而非寫死路徑（修 #937）；diagnosing-bugs Phase 5 在相信 red 之前，先對 pristine copy diff 強制突變——靜默沒改到任何東西的編輯不再能冒充失敗測試（#1209，修 #955）。
    • chief-of-staff 記憶改為 LLM wiki（#1304）：以 index.md 加每個主題一頁維護（透過 ingest、query 與 lint），並以歷史紀錄方式書寫——每個主張都標日期，關於程式碼的主張引用它當時為真的 commit。
    • subagent 以 fresh context window 啟動（#1341）：會 dispatch subagents 的八個 skills（implement-spec、code-review、codebase-design、improve-codebase-architecture、wayfinder、research、grilling、chief-of-staff）改為明確要求每個 subagent 以 fresh context window 啟動，而非 fork 當前對話——部分 harness（Codex）預設 fork，會丟掉 subagent 存在所為的乾淨 context。
    • implement 與 tdd：implement 改以 Skill tool 呼叫 tdd 與 code-review，不再用裸的 /skill 散文（#1189，對齊 #878）；傳入 ticket 參照時先從 issue tracker 取得、開工前報出標題，參照有歧義時先問（#1196，修 #700）；tdd 為每個提議的 seam 加一行說明它抓得到什麼、抓不到什麼，選 seam 不再靠猜（#1192，修 #607）。
    • 個別 skills 修正：grilling 措辭讓「yes」接受建議答案，同意不再等於回答「no」（#1193，修 #706）；handoff 明寫 OS 暫存目錄位置（$TMPDIR，否則 /tmp；Windows 為 %TEMP%）（#1184，修 #272）；teach 測驗輪換正確答案位置（修 #611）、workspace 寫在你執行的目錄而非 skill 資料夾（修 #377）（#1183）；to-tickets 把每張 ticket 開成來源 issue 的 sub-issue（GitHub tracker 模板附上指令），blockers 是原生 edge 時省略 ## Blocked by（#1188）；wayfinder 不再把 maps 或 tickets 標 ready-for-agent、只以真實 issue id 寫交叉引用、research 分支不開 PR、以 label 指名的類型解析每張 ticket（#1181）。
    • setup 模板修正（#1228/#1197/#1169/#1187）：setup-matt-pocock-skills 先接好 git remote 再寫出 GitHub/GitLab tracker（修 #1201），並提供把 legacy CONTEXT.md／CONTEXT-MAP.md git mv 成 GLOSSARY 名稱（修 #1176）；GitHub 模板：關閉前先留言（修 #873）、讀 PR body 兼 comments（修 #1138）、把 Blocking 移進 Conventions 並改用原生 gh flags（修 #855）、點名統計 open blockers 的指令（修 #1118）；GitLab 模板以 -O json 列 MR 並點名 frontier query 的指令（修 #1143）；建立缺失的 triage labels（修 #616）、修 GitLab 模板的 glab 指令（修 #635）、以 --json 讀 GitHub issues 讓 labels 與 body 都進得來（修 #733）、點名 triage-labels.md 的「Label in our tracker」欄（修 #801）；GitHub issue tracker 模板要求 agent 只往使用者自己的 repo 開 issue、絕不開進 mattpocock/skills，並在第一次 gh issue create 前先檢查目標 repo（#1169；#541 至 #550 即是因此在 fork 作業時被開進本 repo）；外部 PR 列表在 authorAssociation 失敗的問題已修（#1187，修 #468）。多項變更需重跑 /setup-matt-pocock-skills 以更新 docs/agents/。
    • wizard 模板修正（#1198/#1237）：ask 改用 Readline 讓方向鍵移動游標（修 #741）；write_env 以單引號包裹值，讓空白、#、$ 與引號在 source 與 dotenv 中存活（修 #770）、寫入時透過 symlink 的 .env 並保留既有檔案的 mode（修 #811）、同時設定 shell 變數（修 #1041）；無瀏覽器開啟器時 open_url 印出自行開啟的警告（修 #774）；ask 與 ask_secret 在 EOF 失敗而非無限迴圈（修 #852）；_existing 解碼雙引號包裹的 .env 值，Enter 保留現值不再存入引號（修 #1220）；stages 在 run_wizard 內執行，中途編輯腳本不再殺掉執行（修 #1142）；_clear 在 tput clear 失敗時回退 ANSI（修 #1081）；移除未使用的 RED（修 #1003）。
    • 既有使用者影響：以 setup 模板維護 docs/agents/ 的 repo 需重跑 /setup-matt-pocock-skills（issue-tracker 模板與 docs/agents/ 皆被改寫）；legacy CONTEXT.md／CONTEXT-MAP.md 若尚未更名，重跑 setup 時會被提供 git mv 選項；在 clone 或 fork 作業的 agent 不再被模板引導把 spec 與 ticket 開進上游 repo。
    上游 Release Notes ↗

  2. v1.3.1

    舊版本2026-10-07
    • 2026-10-28 查核：上游最新 release 仍為 v1.3.1（2026-10-04發布），其後無新版本。
    • 版本定位：v1.2.3→v1.3.1，涵蓋 v1.3.0 與 v1.3.1 兩個 release（皆為 2026-10-04 發布，相隔 56 秒；v1.3.0 之後無跳號）。主軸：三個 skills 畢業進 Engineering bucket、移除 resolving-merge-conflicts、CONTEXT.md 更名為 GLOSSARY.md，以及跨 skill 呼叫慣例的系統性修正。
    • implement-spec 畢業進 Engineering（#1120）：user-invoked，一次執行實作整份 spec——把 tickets 讀成 task graph，在 ready frontier 上以各自的 worktrees 平行跑 implementer subagents，全部落在同一條 integration branch，收尾跑 code-review。目標是 integration branch 而非 PR——只有在 issue tracker 以 PR 關閉工作或使用者要求時才開 draft PR，且要在第一次 merge 之後（沒有領先 main commits 的分支開不了 PR）；各 implementer 先確認 worktree 基於 integration branch、以 tdd 建置 ticket、回報前把 integration tip merge 進自己的分支（每次 merge 都是 fast-forward）。
    • pr 畢業進 Engineering（#1120）：model-invoked，定義 PR body 的形狀——summary 是「讓變更一看就懂的最小視覺」（pseudocode、call tree、file tree、Mermaid、diff）、before/after 證據、以及 merge-danger 判斷（one-way 或 two-way door 與 blast radius）。Summary 視覺化改編自 Dex Horthy 的 show-me（於 CREDITS.md 致謝）。
    • retro 畢業進 Engineering（#1120）：user-invoked，回顧一個 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；完全沒有 guardrail 的 repo 本身就是一個 finding。
    • 移除 resolving-merge-conflicts（#1120）：不再需要、無替代——agent 不靠專屬 skill 也能走完進行中的 merge/rebase conflict。離開 Claude Code plugin、README 與 ask-matt router；docs 頁標記 archived。
    • CONTEXT.md → GLOSSARY.md（#1120）：CONTEXT.md/CONTEXT-MAP.md 領域文件慣例全面更名為 GLOSSARY.md/GLOSSARY-MAP.md（涉及 domain-modeling、grill-with-docs、improve-codebase-architecture、setup-matt-pocock-skills、triage、tdd、diagnosing-bugs、ask-matt、codebase-design、wait-what、pr 與 docs）。既有的 CONTEXT.md 需 git mv 更名——skills 之後只認新名。
    • 跨 skill 呼叫慣例（#878/#880，修 #453）：在 prose 裡点名另一個 skill（「run the /grilling skill」）不可靠——改為明確寫 Call the Skill tool with "grilling"（去掉前綴 / 使其 harness 中立）；一個步驟需要多個 skill 時寫成多次呼叫。同時修正違反「user-invoked skill 不得被其他 skill 呼叫」不變量的六處（to-spec、wayfinder、to-tickets、triage、code-review 原本指示 agent 呼叫 user-invoked 的 setup-matt-pocock-skills，改為請人類執行；diagnosing-bugs 對 improve-codebase-architecture 的 post-mortem hand-off 直接移除）。
    • 其他 patch：六個 skills 的 description frontmatter 因未加引號的 colon-space 成為無效 YAML、被 skills.sh discovery 整個跳過——已加引號修復（#911）；全 repo 散文移除 em-dash 並手寫改句（#905、#879、#917）；domain-modeling 觸發條件擴及「討論 codebase 術語」與「直接編輯 GLOSSARY.md 或 ADR」（#848）；wait-what 遵循 GLOSSARY-MAP.md 索引找到正確的 GLOSSARY.md（#904）。
    • v1.3.1 增量（#1121，修 #1117）：ask-matt 不再宣稱 diagnosing-bugs 會在 post-mortem hand off 給 improve-codebase-architecture（該步驟已移除）——改為修復後指向 /retro 問「什麼能預防這個 bug」，finding 是缺少 seam 時指向 /improve-codebase-architecture。
    • 既有使用者影響：既有 CONTEXT.md/CONTEXT-MAP.md 需要 git mv 更名，否則 skills 讀不到；若以 npx skills 安裝，六個 skills 先前可能因 YAML 無效而未被列出（v1.3.0 起修復）；relying on resolving-merge-conflicts 的流程需移除該步驟。
    上游 Release Notes ↗

  3. v1.2.3

    舊版本2026-08-10
    • 1.2.3（main，2026-08-08 核對）→v1.2.3：統一格式為 vX.Y.Z，核對日期資訊移至 changelog。version 與上游 release/tag 一致（2026-08-06 發布），上游無中介版本。
    • diagnosing-bugs redact secrets（#779）：新增 Redact section，要求在 agent 對 commands/outputs/captured artifacts 採取行動時先 ​<REDACTED>；Phase 1 completion criterion 從「paste invocation」改為「show it redacted」；scripts/hitl-loop.template.sh 提示 capture 會 echo 值。
    • Subagent-dispatch instructions 去掉 Claude Code 專屬名詞（#781）：code-review、codebase-design、improve-codebase-architecture 的 dispatch 步驟去除 Claude Code tool 與 agent-type names，改為在 Codex 與其他 harness 上都能跟著走。
    • wizard：移除 time estimate（#783）：template 拿掉 TOTAL_MINUTES 與 time-remaining 顯示，stage 只收 name、進度以 stages 計數。
    • 上游 main 分支最新 commit 為 2026-08-06T19:49:51Z（release 之後），屬 commit-level 變動、無新版 release。
    上游 Release Notes ↗

圖例

  • 當前版本　本站現在記錄的版本
  • 舊版本　已被取代，保留作歷史對照
  • 已同步　與上游 release 對齊
  • 僅上游變動　上游 main 有 commit，但未發佈新版