/wayfinder：项目目标模糊时，如何用 AI 代理在“战争迷雾”中做规划
摘要：项目启动时，很多关键问题连“该问什么”都无从下手。GitHub 热门项目 AI Skills for Real Engineers 的作者 Matt Pocock 发布了一个名为 /wayfinder 的 AI 编程技能，用“地图—工单—会话”三层结构，帮开发者和 AI 代理在目标尚不清晰时理清思路、逐步探索。本文拆解这套设计背后的动机、原理与适用场景。
从一次访谈说起
Matt Pocock 是 GitHub 上 “AI Skills for Real Engineers” 项目的作者，该项目已收获超过 22 万颗星；他在 YouTube 上还拥有约 34.7 万订阅者。最近他发布了一项新技能 /wayfinder，专门解决一个问题：当项目最终目标还不明确时，如何帮助你和你的 AI 代理理清头绪。
用他自己的话说：“项目就摆在你面前，但一开始很难把所有事情都定下来。”他把这种状态比作“战争迷雾”——你只能摸索着前进，一步一步看清周围的地形。
解决什么问题：从手动规划中解放出来
Pocock 平时大量使用“AFK 代理”（Away From Keyboard，即离线自动运行的 AI 代理）干活，这些代理可以在无人值守的状态下通宵执行任务。他原本的工作流是：先手动规划，写出一份规格说明（spec），再把它拆成一张张工单（ticket）。但规划阶段特别耗时，因为他始终要分心盯着两件事：上下文窗口占用了多少 token，当前规划深度是否合适。
他想摆脱这种束缚，于是设计了一个“编排层”：由它接管整个规划会话，把工作拆成多个线程，并行去做原型验证和调研，最后汇总结果。这样一来，规划者不再需要操心上下文管理，可以专心写出更细致的规格说明，之后再把执行任务放心交给 AFK 代理。
设计思路：用精确的词汇定义信息流
Pocock 的设计起点是一个问题：如果不需要亲自管理任务交接，会怎样？更进一步：如果有一份集中式文档，能把所有零散片段整合起来，又会怎样？
这个思路带来的核心转变在于：技能本质上是在管理代理的上下文，所以他必须认真设计“信息流”。他设想，能不能用一个“审查会话”（grilling session）来管理其他审查会话？
第一步是先搞清楚：被管理的子会话需要什么？结论是，子会话既需要全局的模糊概览，也需要知道自己具体要做什么。由此催生出两份文档：
- 地图（map）：包含所有其他内容，包括所有已做出的决定；
- 工单（ticket）：进入实际会话的任务说明。
Pocock 强调，词汇一旦确定，代理就能非常清晰地把这些实体一一对应起来。如果所有东西都笼统地叫“工单”，或者在不同地方用不同叫法，代理就会混乱。他通过“引导词”让代理准确理解每个部分，同时理清信息流——这套技能就这么成型了。
适用场景：从网站重构到课程规划
/wayfinder 的实际使用范围并不限于工程。工单有几种类型：
- 审查工单（grilling ticket）：发起一次审查会话；
- 原型工单（prototype ticket）：负责创建原型；
- 研究工单（research ticket）：负责开展调研；
- 任务工单（task ticket）：范围最宽泛，负责那些代理做不了、需要人工介入的工作。
Pocock 说，一旦想通这套分类，放哪儿都适用。他不仅把它用在工程上，还用来规划课程内容。为了验证思路，他用 /wayfinder 做了一个测试项目：重构个人网站，并使用 Claude Code 做初始配置。
“战争迷雾”（fog of war）是 /wayfinder 的核心概念：项目刚开始时，很多事情没法一下子敲定。你能做的，是先做出一些决策，让这些决策把你带向下一步，再一步步朝迷雾深处推进——就像玩《魔兽争霸3》时探索地图一样。当“战争迷雾”和“地图”这两个词同时出现在他脑海里时，他发现它们搭配起来格外自然，也确实能把代理引向正确的方向。
关键要点
/wayfinder是一个面向 AI 编程场景的规划技能，特别适合目标不明确、需要逐步探索的项目阶段。- 它的核心结构是“地图—工单—会话”：地图保存全局信息和决策，工单定义具体任务，会话负责执行。
- 工单被划分为审查、原型、研究、任务四种类型，分别覆盖 AI 代理自主执行与人工介入的不同场景。
- 对开发者来说，这套思路最大的价值在于把“上下文管理”从规划中剥离出来，让代理可以更自主地推进前期的调研与验证工作。
本文介绍 Pocock 如何通过统一术语词典，破解人与 AI 代理之间的沟通障碍，并给出两套技能 grill-me 与 wayfinder 的选用标准：小任务快速对齐，大工程系统规划。
统一语言：打破人与 AI 的沟通障碍
为了让 AI 代理真正理解自己的意图，Pocock 先把所有课程重做了一遍，统一采用同一套术语词典，并让自己的所有技能都围绕这套词典运行。这样一来，各项技能基于同样的假设和关键词工作，彼此之间不会出现理解偏差。
这个选择背后是一个很实在的洞察：Pocock 发现，自己与 AI 代理之间存在沟通障碍。而破解之道，是在人与 AI 之间建立一门“共同语言”。
“我一直在做的事情，就是通过技能去找到正确的措辞。”Pocock 说。有意思的是，AI 代理在这方面反而比人更有优势——它很擅长向你展示“换一种说法”的可能性。也就是说，它在领域建模（把业务概念整理成清晰、可计算的结构）方面确实很在行。当你自己说不清需求时，让代理帮你想出更精准的表述，往往能让规划推进得更顺利。
工具选择：grill-me 还是 wayfinder？
既然有两套技能，一个很自然的问题就是：什么时候直接使用 grill-me，什么时候该上 wayfinder？
Pocock 给出的判断标准很清晰：
- grill-me：如果整个计划能在一次会话中完成，并且在动手之前只需要对齐思路，那就用它。大多数小型功能需求都适用——你基本能看清前路，只想让代理确认它与你站在同一边。
- wayfinder：当任务规模更大、前路看不太清，存在大量需要探索的未知区域时，用它来做整体规划。
简单说，小而清晰的任务不需要重型规划工具；真正需要 wayfinder 出场的，是那些你连问题都还没想清楚的大工程。对于 AI 编程来说，这其实揭示了“规划”的本质——不是画一张详尽到每一步的图纸，而是建立一套让你和 AI 在同一套语言体系下共同探索未知的框架。
关键要点
- wayfinder 的核心价值：把 AI 代理“探索未知”的能力封装成可复用的规划工具，帮助开发者在大型项目中理清思路。
- 术语词典是关键：统一所有技能和 AI 代理的术语口径，能有效消除人与 AI 之间的“沟通障碍”，让多方协作基于共同语言。
- 工具选择标准：小任务用 grill-me 快速对齐思路；复杂大工程用 wayfinder 做整体规划——关键在于评估你对问题的清晰程度。