📝

Wayfinder 是 Matt Pocock 的跨会话 AI 规划 Skill——把超大工程拆成 issue tracker 上的一张"决策地图"，用 research/prototype/grilling/task 四类 ticket 逐个消除 fog of war，直到通往目的地路径清晰。单会话装不下的野心，交给地图。

Matt Pocock 教学：大项目别硬拆，用 Wayfinder 跨会话规划

来源：小红书视频《MattPocock教学：大项目别硬拆,用wayfinder》（ChHsich 搬运，908 秒完整教学）+ mattpocock/skills 仓库的 skills/engineering/wayfinder/SKILL.md（11.9KB）。本文基于视频转写整理。

Matt Pocock 在视频开头抛出一个扎心观察：“我找到了一种用 agent 规划任意规模工作的方式。以前用的规划工具——包括我自己做的——都太受限、太绑死在单次会话里。”

他为此感到不适的是：因为工具限制，他被迫把自己要做的东西缩小来迁就 AI（”constraining the stuff I was building to fit AI”）——这感觉不对。Wayfinder 就是他的答案：一个把超大工程规划搬进 issue tracker 的 Skill，让规划可以横跨任意多次 agent 会话，直到路清晰为止。

问题：为什么单会话规划不够

之前的工作流核心是 grill-me / grill-with-docs——它依然是超级重要的原语，但绑死在单次会话。^[raw/articles/2026-07-13-grill-me-update.md]
有些工作比 agent 的上下文窗口（尤其”smart zone”）还大，你事先就知道装不下。
于是你只能预先把它切成小块：”我就咬这一口””我就咬这一口”——然后没几步就撞上答不了的问题，迷失在 fog 里。
全程你还在管理 smart zone、省 token，规划质量被反复打断。

Wayfinder 的做法：把”规划”本身变成一张共享地图，不再试图在一个会话里塞下整个计划。

核心概念：Map / Tickets / Fog of War / Frontier

Wayfinder 的思路来自软件开发基本功（”我在 AI 之前当真程序员时学到的规划基本功”）：

Destination（目的地）：第一件事是定义”到哪算完”。它可以是：一份可构建的 spec、一个待锁定的决策、或一个就地完成的变更（如数据迁移）。目的地定了，范围就定了。
Map（地图）：一张 issue tracker 上的主 issue（标签 wayfinder:map），是索引而非仓库——只列”已做决策”一行一个 gist + 链接，细节住在各自的 ticket 里。
Decision tickets（决策 ticket）：地图的子 issue，每个解决一个决策/调查——不是”执行的切片”。每个 ticket 的大小以”一个 100K token 的 agent 会话”为准。
Fog of war（战争迷雾）：地图刻意不完整。看不清但知道会来的决策，写进地图的 “Not yet specified” 区；随着 frontier 推进，”迷雾”逐渐”毕业”成新 ticket。
Frontier（前沿）：开放、未阻塞、未认领的 ticket 集合——当前可以下手的决策边缘。

Fog or ticket? 判据只有一个：现在能否精确陈述这个问题（不是能否回答它）。能 → 建 ticket（即使被阻塞）；不能 → 留在 “Not yet specified”。

四种 Ticket 类型（HITL / AFK）

每个 ticket 都标 HITL（Human In The Loop，与真人协作）或 AFK（agent 独立完成）：

类型	模式	做什么	何时用
Research	AFK	查文档/API/资料，带回事实	决策等一个外部事实时；charting 阶段立即并行开火
Prototype	HITL	造廉价粗糙的具体物（outline/stub/UI 逻辑）给人反应	“应该长什么样/怎么表现”是关键问题时；防瀑布流
Grilling	HITL	用 grilling/domain-modeling 技能一次一个问题地对话	默认情形，实现细节需要讨论时
Task	HITL 或 AFK	决策前必须做的真实世界杂活（配配置、约人、跑腿、搬数据）	无决策可做但讨论被卡住时

Blocking 用 issue tracker 的原生依赖关系——这样 frontier 会在 tracker 自己的 UI 里可视化出来，人不用打开地图就能看到哪些可认领。

工作流：Chart the map → Work through the map

Chart（画图）——用户给一个模糊想法：

先跑 grilling + domain-modeling 钉死 destination（范围由它定）
广度优先再 grill 一轮，把整个空间的开放决策和当下可做的第一步都翻出来；如果这轮没翻出 fog（路已经清楚、单会话装得下）→ 不需要地图，直接问用户怎么走
建地图（Destination + Notes + 迷雾草稿）
建现在能精确陈述的 ticket（子 issue）→ 第二遍才连 blocking 边（issue 需要 id 才能互相引用）
并行开火 research subagents，在 throwaway 分支上收集发现

Work through（走图）——用户带着地图/ticket 来：

加载地图（低分辨率视图，不是所有 ticket 正文）
选 ticket（用户点名或取 frontier 第一个）→ 先认领（assign 给自己）再动手
Zoom as needed：按需拉取相关 ticket 全文，调用 Notes 里点名的技能
记录 resolution（评论贴答案）→ 关 issue → 在地图 Decisions-so-far 追加一行
毕业新 ticket：迷雾被照亮的补新 ticket，blocking 第二遍连；发现 ticket 越出目的地 → 直接关掉写进 Out of scope

纪律：一次会话只解一个 ticket（research 例外）。用户可并行跑多个未阻塞 ticket，所以要做 tracker 并发编辑的心理准备。

与常规工作流的衔接：to-spec → to-tickets

地图走完后（14/17 个 ticket 已关、但 skill 还没建——这就是决策型规划），Matt 的收尾：

1
2
3

grill-with-docs → to-spec → to-tickets → implement → code-review
        ↓ 变成
Wayfinder（大图）→ to-spec → to-tickets → implement → code-review

关键增值：Wayfinder 生成的 spec 极密，且每个决策都链回原始 ticket——agent 困惑时能直接看 primary source。这补上了 grill-with-docs 的老弱点：spec 只是会议纪要的摘要，摘要不是真相。

他自己举的例子：给 CVM 加 command palette，destination 是一份可构建的 spec。开局 7 个 ticket，但只有 3 个当下可做（icon 名从哪来 / 组件存储 schema / palette 信息架构 + 网格键盘）。逐个在新会话里 Wayfinder <ticket name> 推进。

FAQ（视频里的原话回应）

Q: 太重了，什么时候该用？

“如果这活儿单会话就能做完、路你已经知道——就直接单会话做。Wayfinder 是给有 fog of war 的情况。”（他自己还在用它规划花园办公室这种非编码项目——site survey、找建筑商、查资料。）

Q: 这不就是 SDD（spec 驱动开发）吗？

“spec 只是多会话工作的目的地文档。区别在于：我走完就关掉那个 issue，spec 跟着消失——代码里实现了它就完成了使命。SDD 的人会回去反复编辑 spec，我不会。这些 spec 是非持久的。“

配套生态

garden office 案例：Wayfinder 可用于任何”野心够大、路不清楚”的规划，不限于编程。
issue tracker 无关：GitHub / Linear / Jira 都行（/setup-matt-pocock-skills 配置）。
与 grill-me 的关系：grill-me 是单会话原语（本集合的”审问”基础），Wayfinder 是它的跨会话放大版——用同样的 grilling 技术，但把决策沉淀成地图。
同仓库还有 handoff（自动生成子 agent prompt）、to-spec、to-tickets、research、prototype 等配套 skills。

🎓 Matt 在结尾推荐了 AI Hero 站的 7 节免费课程（AI skills for real engineers），”build up a repeatable workflow… built on solid software fundamentals”。

我的评价

Wayfinder 解决了 vibe coding 时代一个真实痛点：工具逼你把野心缩小。它的”决策 ticket ≠ 执行 ticket”+”迷雾不硬画”+”blocking 可视化”三件套，本质是把软件工程的规划基本功（里程碑、依赖、范围控制）重新搬回 agent 工作流。对单会话装不下的中大型项目，比硬拆成一个个独立 prompt 要系统得多。