情境背景

你剛在自己的 repo 跑完 npx skills@latest add mattpocock/skills，也執行了 /setup-matt-pocock-skills 把 docs/agents/issue-tracker.md 與 docs/agents/domain.md 寫進去。現在你想加一個「使用者可以匯出自己的訂單紀錄成 CSV」的功能，但面對 25 個 skills，你不確定要先規劃、先研究、還是直接寫。

/ask-matt 就是為這個情境設計的路由器。它不會幫你寫程式，它會讀你目前的對話脈絡，推薦 1 到 3 個最適合的 skill 並說明順序。

第 1 步：呼叫路由器

目標：讓 /ask-matt 分析目前的對話脈絡並給出建議

AI 對話：

• You:

  /ask-matt
  我想替訂單 API 加一個批次匯出 CSV 的功能，目前不確定要先做規格、架構調查或原型。

• AI:

  我讀過你的對話脈絡與 docs/agents/ 下的設定。這是一個需要先釐清需求的新功能。

  推薦順序：

  1. /grill-with-docs 先與你逐步追問，確認匯出範圍（哪些欄位、哪些時間區間、誰有權限），並把「訂單」「匯出」這些詞寫進 CONTEXT.md。
  2. /to-spec 把對話共識整理成規格，發佈到你設定的 issue tracker。
  3. /to-tickets 把規格拆成可並行或有序的 tracer-bullet tickets，再交給 /implement。

  它們各自不重複。/grill-with-docs 管需求與共享語言，/to-spec 管規格化，/to-tickets 管執行順序。

第 2 步：理解路由器回覆的結構

/ask-matt 的輸出通常包含三個區塊，看懂了就能自己判斷要不要照走。

推薦順序的解讀

每一條推薦會附「為什麼」。例如上面建議的第一步是 /grill-with-docs，理由是你的需求裡有「批次」「匯出」「訂單」這些尚未定義邊界的詞。如果今天你已經有 spec，路由器會跳過 /grill-with-docs，直接推薦 /to-tickets。

Standalone 路由

有些 skill 是獨立分支，不會進入主流程。例如 /wizard 是「只有人類能做的步驟」時的 on-ramp，與開發流程不衝突。/ask-matt 會把它們單獨列出。

Phase 邊界決策

當你 session 接近尾聲，或要切換 harness 時，/ask-matt 會走 phase 邊界決策樹：continue 優先、/clear 用於任務完成、/handoff 用於有東西需要旅行到另一台機器、/compact 是最後手段。

第 3 步：選一個開始

目標：依照推薦呼叫第一個 skill

AI 對話：

• You:

  好，那先跑 /grill-with-docs。

• AI:

  開始 /grill-with-docs。第一個問題：你說的「訂單」是指訂單主檔，還是包含退款與作廢的訂單事件？

路由器把你放到正確 skill 的入口，剩下的對話就交給該 skill 的流程。

常見誤解

/ask-matt 不會幫你寫程式

它是路由器，不是實作工具。如果你期待它直接給程式碼，你會失望。它輸出的是「下一步該用哪個 skill」。

不要把 /ask-matt 當作每次都跑的前置指令

當你熟悉 skills 之後，可以直接呼叫目標 skill。路由器是給不確定的人用的，重複呼叫只會多一層對話。

/ask-matt 的建議會隨對話脈絡更新

如果你剛剛做完 /to-spec，再呼叫 /ask-matt 不會再叫你做 spec。它讀的是當下脈絡，不是固定流程。

工具使用摘要

結果

• 確認下一步該用 /grill-with-docs 而不是直接寫程式
• 釐清 /ask-matt 與其他 skill 的分工
• 學會讀路由器輸出的三個區塊：推薦順序、Standalone、Phase 邊界

關鍵學習點

• /ask-matt 是路由器，不實作。它的輸出是「下一步該用哪個 skill」與順序建議。
• 推薦是基於對話脈絡，做完一個 skill 後再呼叫會得到不同的下一步。
• 熟悉 skills 後可直接呼叫目標 skill，不必每次都過路由器。
• Phase 邊界（continue / clear / handoff / compact）是另一條獨立決策樹，不是開發流程的一部分。