跳轉到

來源

簡介

Matt Pocock 發布了他的 AI Coding Agent Skills 儲存庫 v1.1 版本。這是一次大幅度的更新,包含:兩個核心流程 skill 的更名(/to-prd → /to-spec、/to-plan + /to-issues → /to-tickets)、grilling(提問訪談)機制的重大改進、一條完整的開發生命週期流程(idea → spec → tickets → implement → code review),以及最重要的新 skill——/wayfinder,專門用來規劃「大到一個 agent session 裝不下」的大型專案。此外 /tdd 也改為 reference-only 模式,讓 agent 可以自主(AFK)運作。

主題整理

  1. v1.1 發布概述與升級方式
  2. Skill 更名:/to-spec 與 /to-tickets
  3. Grilling(提問訪談)skill 改進
  4. 完整的開發生命週期流程
  5. Code Review:加入 Fowler 重構壞味道
  6. 全新 /wayfinder:大型計畫的規劃地圖
  7. 支援型 skills:/research 與 /prototype
  8. /tdd skill 更新
  9. 遷移指南與注意事項
  10. AI Coding Crash Course 課程公告

筆記地圖

flowchart TD
    A[Skills v1.1 發布] --> B[Skill 更名]
    A --> C[Grilling 改進]
    A --> D[完整開發生命週期]
    A --> E[/"/wayfinder 大型規劃"/]
    A --> F[支援型 Skills]
    A --> G[/"/tdd 更新"/]
    A --> H[遷移指南]

    B --> B1["/to-prd → /to-spec<br/>(spec 成為統一術語)"]
    B --> B2["/to-plan + /to-issues<br/>→ /to-tickets"]

    C --> C1["確認閘門<br/>(confirmation gate)"]
    C --> C2["事實 vs 決策分離<br/>Facts vs Decisions"]

    D --> D1["idea → /to-spec<br/>→ /to-tickets → /implement<br/>→ /code-review"]
    D1 --> D2["code-review 加入<br/>Fowler 重構壞味道"]

    E --> E1["fog of war 迷霧概念"]
    E1 --> E2["地圖 = issue tracker 上的<br/>wayfinder:map issue"]
    E2 --> E3["每張 ticket = 一個決策<br/>大小 = 一個 agent session"]
    E3 --> E4["HITL / AFK 分類"]
    E4 --> E5["迷霧清除後<br/>交棒給 /to-spec"]

    F --> F1["/research:背景研究<br/>產出有引用的 Markdown"]
    F --> F2["/prototype:改為 model-invoked<br/>供 wayfinder 自行呼叫"]

    G --> G1["改為 reference-only<br/>支援 AFK 自主運作"]
    G --> G2["Refactor 移出 TDD 迴圈"]

    H --> H1["npx skills@latest add<br/>mattpocock/skills"]
    H1 --> H2["手動清除舊 skill 資料夾"]

主題內容

1. v1.1 發布概述與升級方式

  • 經過長時間開發,v1.1 終於正式釋出,包含大量變更:全新的 grilling 方法、多個既有 skill 的更新,以及兩個主要流程 skill 的更名。
  • 因為這次包含 skill 更名與合併,安裝器不會自動處理,必須手動重新執行安裝並清理舊資料夾。
  • 升級指令:npx skills@latest add mattpocock/skills

2. Skill 更名:/to-spec 與 /to-tickets

  • /to-prd 更名為 /to-spec
    • 關鍵洞察:原本產出的文件其實不是 PRD(產品需求文件)。PRD 只描述產品本身,但實際產出的內容常混入非產品的技術事項。
    • 真正產出的是 specification(規格)——一個更廣義的詞,可以是技術性、非技術性或兩者混合。
    • 「Spec」從此成為整套 skills 的單一貫穿術語(single through-line term)。
  • /to-plan + /to-issues 合併為 /to-tickets
    • 舊名稱「issues」偏向 GitHub / Linear 的用語,不夠通用。
    • 新概念:spec 之下有一組 tickets——實現 spec 的旅程。
    • /to-tickets 產出一組帶有「阻擋關係(blocking edges)」的 tickets,同一份產出可以有兩種讀法:
      • 本地檔案 tickets.md:依序由上而下執行的計畫
      • 真實 issue tracker:以原生 blocking 連結呈現的 DAG,多個 agent 可平行認領未被阻擋的 ticket

3. Grilling(提問訪談)skill 改進

  • 確認閘門(confirmation gate):agent 在你確認「已達成共同理解」之前,不會開始執行計畫——把原本隱含的完成條件變成明確的停止閘門。
  • 事實 vs 決策(Facts vs Decisions)分離:
    • 事實 → agent 自己查(探索 codebase)
    • 決策 → 必須交給人類回答並等待
    • 修正了先前 /wayfinder 測試中「agent 自問自答、不問人類」的問題。

4. 完整的開發生命週期流程

  • v1.1 建立了一條完整的主流程:idea → /to-spec → /to-tickets → /implement → /code-review
  • /ask-matt 路由器現在會依此主流程導引。
  • /wayfinder 定位為「情境式入口(situational on-ramp)」而非新的主流程——以 grill 為首的 idea → ship 鏈仍是正門。

5. Code Review:加入 Fowler 重構壞味道

  • /code-review 採雙軸審查,以平行 sub-agents 執行、互不污染:
    • Standards 軸:是否符合 repo 的 coding standards,並以 Martin Fowler 的重構壞味道(refactoring smells) 為基準
    • Spec 軸:是否忠實實作了原始 issue / spec 的要求

6. 全新 /wayfinder:大型計畫的規劃地圖

  • 適用情境:一個模糊的大想法,大到一個 agent session 裝不下——會超出 agent 的「smart zone」甚至 context window 上限。此時需要拆分成多個部分才能找出方向。
  • 核心比喻:fog of war(戰爭迷霧)——你能感覺到工作的形狀,但還無法寫成 spec 或計畫。
  • 運作方式:
    • 第一步是命名目的地(destination)——在任何 ticket 存在之前,先定錨範圍。
    • 在 repo 的 issue tracker 上建立一張共享地圖:一個 wayfinder:map issue,tickets 是它的子 issue。
    • 地圖是索引而非儲存庫:每個決策只存在於它的 ticket,地圖只做摘要與連結。
    • 每張 ticket 是一個「決策」,大小刻意設計為一個 agent session;tickets 之間以 blocking 關係連結,前置未解決就不能處理後續。
    • Frontier(前線)= 開放、未被阻擋、未被認領的 tickets,tracker 的原生 blocking 會視覺化呈現。
    • 一個 session 最多解決一張 ticket,以 resolution comment 記錄答案、關閉 ticket、並在「Decisions so far」加上一行索引。
  • HITL / AFK 分類:每張 ticket 屬於 HITL(human in the loop,例如 grilling、prototype)或 AFK(agent 獨自完成,例如 research)。HITL ticket 只能透過與人類的即時對話解決。
  • 無迷霧提前退出(no-fog early exit):若開場的 grilling 沒有發現迷霧,代表工作小到一個 session 就能完成,skill 會直接停止,不建立多餘的地圖。
  • 交棒:迷霧清除、路線明朗後,交給 /to-spec 排定多 session 的建置(若工作其實很小,直接實作)。
  • Wayfinder 只做規劃、不做執行:產出的是決策,不是交付物。

7. 支援型 skills:/research 與 /prototype

  • /research:針對高可信度的一手來源進行調查,把發現寫成帶引用的 Markdown 檔存進 repo,以 background agent 執行——不打斷你的工作流。
  • /prototype:改為 model-invoked,讓 wayfinder 可以自行呼叫。提供兩種原型類型,在寫 spec 之前先探索設計空間:
    • 可執行的 terminal app(回答狀態 / 邏輯問題)
    • 多個風格迥異的 UI 變體(可在同一 route 切換)

8. /tdd skill 更新

  • 回應許多使用者的需求:希望能把 /tdd 丟給 AFK(無人值守)agent 直接運作。
  • 舊版會列出步驟並要求逐步確認,不符合多數人使用 TDD 的方式。
  • 新版改為 reference-only(純參考資料):不規定具體步驟,只錨定關鍵順序 red → green → refactor。
  • 關鍵變更:refactoring 不再是 TDD 迴圈的一部分,並新增了缺漏的 anti-pattern 說明。

9. 遷移指南與注意事項

  1. 執行 npx skills@latest add mattpocock/skills 重新安裝(可自由挑選要裝的 skills)。
  2. 安裝時務必選取 /setup-matt-pocock-skills 並在 agent 中執行一次(設定 issue tracker、triage 標籤、文件位置)。
  3. 手動檢查 skills 資料夾,確認沒有殘留的舊 skill(/to-prd、/to-plan、/to-issues 等舊名已不存在)。

10. AI Coding Crash Course 課程公告

  • 影片結尾 Matt 宣布了 AI Coding Crash Course 課程,可透過他的 newsletter / aihero.dev 取得最新消息。

Recap 重點整理

一句話總結

v1.1 用「spec」統一了整套語言,補齊了 idea → /to-spec → /to-tickets → /implement → /code-review 的完整開發生命週期,並新增 /wayfinder 來規劃「大到一個 session 裝不下」的迷霧型大專案。

  • 升級指令(最重要的命令): 
    npx skills@latest add mattpocock/skills
  • 更名對照:/to-prd → /to-spec;/to-plan + /to-issues → /to-tickets
  • /wayfinder 的判斷準則:「能否精確地提出問題」決定它是 ticket;「能否回答」不是重點——能提問就是 ticket,不能提問就還在迷霧裡。
  • Grilling 鐵律:事實自己查,決策問人類;未確認共同理解前不動工。
  • /tdd 現在是 reference-only,可交給 AFK agent 自主執行;refactor 已移出 TDD 迴圈。
  • 更名與合併不會自動遷移,升級後務必手動清理舊 skill 資料夾。

工具及參考資料

工具

參考資料

領域

AI #AICoding #CodingAgent #ClaudeCode #AgentSkills #軟體工程 #開發流程 #TDD #CodeReview #專案規劃