wayfinder skill 是什麼、怎麼用：Matt Pocock 給超大型工作做規劃的 Skill，用「決策任務單」畫地圖

本文根據 mattpocock/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 64.5 萬次；所在倉庫 mattpocock/skills 在 GitHub 約 28.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

有些事大到一個智能體會話根本裝不下：重寫計費系統、設計一整門課程。硬着頭皮讓它「先做個計劃」，得到的往往是細節全靠猜的長文。wayfinder 的態度是承認現在看不清路。description：把一大塊工作（超出單個會話的容量）規劃成 issue 跟蹤器上一張由決策任務單組成的共享地圖，一次解決一張，直到通往目的地的路清晰為止。它只能手動調用。

幾個關鍵概念：

• 目的地：每次努力的終點不同，說出它是畫圖的第一步——可能是一份可以交接和迭代的規格，可能是開始規劃前必須鎖定的一個決定，也可能是一次就地完成的改動（如數據結構遷移）。
• 地圖：跟蹤器上的一個共享條目，彙總全部任務單的狀態。
• 決策任務單：它們是問題，解決的結果是一個決定，而不是要執行的構建切片。
• 戰爭迷霧：遠處看不清的部分先不展開，等前面的決定落定再說。

說明裏有一節叫「只規劃，不動手」：wayfinder 預設是規劃活動，地圖在路徑清晰時就算完成，實現交給別的技能。它還強調不限於工程——課程內容之類的工作只要形狀合適也能用。調用分兩種：繪製地圖和沿地圖推進。

怎麼安裝

wayfinder 隨 mattpocock/skills 整套安裝。Claude Code 用插件（命令來自倉庫 README）：

text
claude plugin install mattpocock-skills@claude-plugins-official

Codex 先 codex plugin marketplace add mattpocock/skills 再 codex plugin add mattpocock-skills@mattpocock；Cursor、OpenCode 等用 npx skills@latest add mattpocock/skills，在列表裏勾選需要的技能。README 提醒兩點：插件和 skills.sh 兩種方式每個工具只選一種，否則每個技能會出現兩份；勾選時帶上 setup-matt-pocock-skills，並在每個倉庫裏先運行一次，它會問你用哪個 issue 跟蹤器、分診用哪些標籤、文檔存在哪裏——庫裏不少技能依賴這份配置，也會互相調用。

倉庫整體介紹和其他安裝方式，詳見本站《mattpocock/skills 是什麼、怎麼安裝：Matt Pocock 的工程師 Skills（grill-me、tdd、to-spec）》。

怎麼用

• /wayfinder 我們要把單租戶架構改成多租戶——它先和你確定目的地，再在跟蹤器上建地圖和第一批決策任務單。
• 之後每次開新會話：/wayfinder 繼續，它讀地圖，挑一張沒有前置依賴的任務單和你一起解決。
• 路徑清晰後，用 to-spec、to-tickets 把結論轉成規格和實現任務。

適合誰 / 侷限

適合規劃跨多周、涉及許多未知數的大型改造。小功能用它是殺雞用牛刀；它會在跟蹤器上產生一批條目，團隊需要接受這種用 issue 記錄決策的做法；規劃週期變長，適合「想清楚比做得快更重要」的工作。

注意事項

• 許可：MIT。
• 會創建和更新 issue，對團隊可見；需要先運行 /setup-matt-pocock-skills。
• 這個技能的說明文字較長，加載時會佔用一部分上下文。