快速开始
npx skills add mattpocock/skills --skill=wayfindernpx skills update wayfinder功能说明
wayfinder 接手一个规模过大、单个智能体会话无法容纳的工作——它被迷雾笼罩，从这里到目标的路径尚不可见——并将其绘制成一张共享地图，地图由你的问题追踪器上的决策任务（decision ticket） 构成，然后逐个解决这些任务，直到路径清晰。它负责规划，不负责执行：每个任务解决一个决策——一个需要确定的问题，而不是一个需要执行的构建切片——当地图上没有人在开始构建之前还需要决策的事项时，地图就完成了——所以它产出的是决策，而不是可交付成果。
何时使用
你通过输入 /wayfinder 来调用它——智能体不会主动使用它。
当一个工作超出单个智能体会话的承载能力，且到达其目的地的路线仍然模糊时使用它——你能感受到工作的轮廓，但还无法将其写为规格说明或计划。对于将已经清晰的线索转化为规格说明，请使用 to-spec；对于将已经理解的计划切片为可构建的任务，请使用 to-tickets。Wayfinder 位于两者的上游：当迷雾太重无法直接编写规格说明时，你就运行它。
前置条件
地图及其任务存放在代码仓库的问题追踪器上，所以 wayfinder 需要 setup-matt-pocock-skills 铺设的追踪器接线——它会生成一个"路径查找操作"章节，描述地图、子任务、阻塞关系和前沿查询在 GitHub、GitLab 或本地 markdown 中的表达方式。如果没有该文档，wayfinder 默认使用本地 markdown 地图。
地图是索引，迷雾是前沿
地图是一个单一的 wayfinder:map 问题，其任务是它的子问题——一个整个团队都可以关注的共享 URL。它是一个索引，而不是存储库：每个决策只存在于一个地方（它的任务中），地图只提供摘要和链接，从不复述内容。一个会话以低分辨率加载地图，并按需放大到单个任务。
在实时任务之外是战争迷雾——你能感觉到即将到来但还无法确定的决策。判断某样东西是任务还是仍然在迷雾中的标准是：你现在能否精确地陈述这个问题，而不是能否回答它。解决一个任务会清除其前方的迷雾，将现在可以明确化的内容毕业为新的任务。前沿是那些已打开、未被阻塞、未被认领的任务——已知领域的边缘——追踪器原生的阻塞功能以可视化的方式呈现它，这样你不用打开地图就能看到哪些任务可以被领取。迷雾只朝着目的地方向聚集；超出目的地的部分被裁定为范围外，关闭，永远不会毕业。
每个任务要么是 HITL（人在回路中——拷问、原型验证），要么是 AFK（智能体独立完成——研究）；HITL 任务只能通过实时交流来解决，所以智能体永远不会回答自己的问题。研究任务仍然是一个真实的任务——下游决策所依赖的共享阻塞项——但因为它是 AFK 的，会话不会停下来阅读：它会启动一个 /research 子智能体来并行地消灭这个任务，保持前沿的快速推进，并将发现记录在一个临时性的 research/<name> 分支上。
成功的标志
- 命名目的地是第一个动作——在任何任务存在之前——因为它固定了衡量每个任务的范围。
- 一个地图就是一个
wayfinder:map问题；任务是它的子问题，通过名称引用，而不是光秃秃的#42。
- 一个会话最多解决一个任务（研究任务除外），将答案记录为决议评论，关闭任务，并在迄今为止的决策中追加一行指针。
- 如果开场的拷问揭示没有迷雾，它就会停止并告诉你，这个旅程规模太小，不需要地图。
在整个流程中的位置
wayfinder 是一个大型构思的入口匝道：一个规模太大、迷雾太重无法一次性编写规格说明的工作，会生成一张已清理的决策地图，然后汇入主构建流。当迷雾被推开、路径清晰后，移交给 to-spec 来安排多会话构建（或者，如果工作最终很小，直接实现）。它依赖 grilling 和 domain-modeling 来解决单个任务，依赖 prototype 和 research 来处理需要它们的任务类型。当你不确定哪个技能或流程适合时，可以找 ask-matt 帮你导航。