Matt Pocock 在一场一个多小时的直播里用一个真实需求演示了 Wayfinder 这个新技能。需求是他自建的内容创作平台要加一个 TikTok 竖屏发布功能。全程没有幻灯片只有一张不断被填满的决策地图和一堆被逐一敲定的问题。这篇文章把这条「先画地图、再动工」的路线拆开讲。雾里的需求Wayfinder 是 grill-me 的进化版。grill-me 是一次提问式会话把模糊想法盘问清楚。Wayfinder 把这个过程升级成了编排器一次可以管理好几场并行会话。Matt 在开场就说这是用来一次搞清楚一大块工作的工具。他今天要动的是自己的 Course Video Manager一个集视频剪辑、缩略图、文案、选题库于一身的内容创作平台。他想给这个平台加一个 TikTok creator能复用现有的普通视频换一种竖屏播放器样式还希望能直接发布到 TikTok。这段口述很模糊。他自己也承认有大量雾气不知道 TikTok 视频到底怎么定义、发布流程怎么走、和现有的 pitch 系统什么关系。而 Wayfinder 的价值恰恰是穿过这团雾。找路不盖楼Wayfinder 的核心动作是画一张决策地图。它先钻进代码库看看有什么摸清现状随后开始提问。整个工具只负责从当前位置到目的地这一段也就是 pre-spec 阶段。这里有个关键确认直播一开始工具就问 Matt 目的地是什么。答案是锁定一组决策、产出一份可以交给实现代理的 spec而不是一段能跑的代码。Wayfinder 管的是把模糊需求收敛成明确决策落代码是后面的事。先探测再提问第一个实质问题是 TikTok 视频相对于现有视频是什么。Matt 翻开 schema.ts发现 videos 表已经够用TikTok 视频只是同一张表上一个不同的属性一个 format 字段。他定下几条原则创建要低摩擦、不强制关联 pitch、点个按钮就能开始。这里有个次序很关键。工具先理解领域再提问题对着代码库的既有结构问出一个个能被拍板的决策。换模型之外的杠杆直播中途有人问模型怎么选。Matt 顺手画了一张图把一个 agent 拆成三层。中间是模型比如 Opus 或 GPT。模型外面是 harnessClaude Code、Codex 这类执行外壳。再外面是 environment文件系统、代码库、以及一切 agent 操作的对象。他的判断是人人都在换模型、升级模型可模型只是画面的一小块。harness 和环境是可以免费改进的杠杆价值各占一半。这个视角解释了他为什么把大量精力花在打磨 skills 和工作流上而不是追逐最新的模型。一张地图九张票探测完现状Wayfinder 开始生成产物。它在 GitHub 上开了一个 issue 当主地图下面挂九个决策子任务。地图本身很简洁重活都委托给这些子任务。九张票分三种类型。grilling 票靠对话敲定一个决策prototype 票靠生成原型让长什么样看得见research 票直接派 agent 去查证事实再回报。票之间有阻塞关系地图会标出哪些能并行抓、哪些得等前面的决策落地。research 票是省心的一类。四个 API 调研任务自动派出去回来时直接落成文档页挂在票下面当证据。枚举比布尔更耐扩展敲到这个视频是竖屏还是横屏时工具建议用一个布尔值 isShort。Matt 拒绝了。他翻出仓库里已有的约定pause type、silence length 用的都是 enum。他的理由很朴素。布尔值会悄悄埋雷。今天只要区分横竖加一个布尔就够了哪天冒出第三种形态就得再堆一个布尔三个布尔能凑出六种状态组合。enum 只有三种状态一个字段干净利落。这是多年工程直觉在替未来做选择。说不清就上原型到了 TikTok 列表页长什么样这种问题光靠文字已经问不出来了。Matt 直接要求升一个原型。prototype 技能会在真实代码里搭出几个 A/B 变体让他在浏览器里点着看。他反复强调这是提高讨论保真度的关键。文字描述一个竖屏播放器时双方脑子里是两幅图。原型把抽象拉回具体几秒就能看出哪个变体顺眼。Matt 的结论是宁可烧掉大量上下文换一个能看的原型也不要在字面上来回猜。撞墙就绕路走到发布环节一个障碍冒了出来。TikTok 要求每个帖子过一道审核门槛成本高得离谱。Matt 没有硬啃而是转身换了一条路用 Buffer 这个排队发布服务来接。上传 DropboxZapier 检测到文件再推给 Buffer。付一点 Buffer 的订阅费换掉整套 TikTok 审核的麻烦。这笔账在他看来很划算。决策地图的作用在这里也体现出来它让这里有个坑这件事被及时标记而不是闷头实现到最后才发现。把地图走完一个多小时直播九张票推进到了八张。地图上每个已敲定的决策都被记录在案链接到对应的研究和文档。Matt 关掉直播时地图已经变成一份足够详尽的决策记录。他最后把完整流程串了一遍。Wayfinder 画地图、拆决策票接着 to spec 把地图收敛成一份大规格再 to tickets 拆成实现子任务每个子任务在独立上下文里实现最后 code review 和人工 review 收尾。决策票靠做出决策来关闭实现票靠把决策写进代码来关闭两者不能混为一谈。三条能带走的原则这场演示留了三条判断。其一spec 先于实现把模糊需求收敛成明确决策再动手返工最少。其二枚举优于布尔凡是有可能长出第三种取值的字段一开始就用 enum。其三聚焦 harness换模型不如打磨执行外壳和工作环境。这三条都不需要买什么新工具是纯粹的工作方式改进。附录 术语对照与来源说明本文基于 Matt Pocock 的直播视频《The /wayfinder Demo》改写整理观点与流程忠于原视频结构与表述面向中文读者重新组织。术语说明Wayfinder把模糊需求收敛成决策地图的编排器grill-meWayfinder 的前身单次提问式会话pre-spec动手写代码之前的阶段Wayfinder 只负责这一段spec一份可以交给实现代理的规格文档grilling 票靠对话敲定一个决策prototype 票生成原型让设计看得见research 票派 agent 查证事实再回报harness模型之外的执行外壳如 Claude Code、Codexenvironment文件系统、代码库等 agent 操作的对象to spec / to tickets把决策地图收敛成规格、再拆成实现子任务的后续步骤素材来源直播视频《The /wayfinder Demo》作者 Matt Pocock#AI编程 #Claude #ClaudeCode #需求分析 #AI工作流 #spec #提示词 #效率工具 #程序员 #开发流程