wayfinder —— 把装不进一次会话的大工程，画成一张决策票据地图

技能概述

wayfinder 是一个规划类智能体技能：当你手里只有一个模糊的大想法、而"从这儿到目标"的路还看不清时，它先把路线画成 issue tracker 上的一张共享地图，再逐张处理地图上的决策票据，直到路走通、可以交给别人去执行。

适用场景

1. 需求太大，一次会话装不下 —— 当一件工作明显超出单个 100K token 会话的容量，硬做只会做到一半丢上下文。先用它把前方的关键决策逐一落定，再分段实施，每个会话都能只看自己那张票据。
2. 方案还没想清楚，就先别写代码 —— 大型重构、数据结构迁移、新系统选型这类"想错了代价很大"的活儿，地图让你在动手前先把该锁的决定锁死，避免返工。
3. 多个会话或多个 agent 并行推进同一件事 —— 地图和票据都落在 issue tracker 上，每个会话认领一张、认领即"指派给自己"，阻塞关系在 tracker 原生界面里直接可见，谁都不会踩到别人的脚。

核心功能

1. 地图即索引（The Map） —— 地图本身是一个带 wayfinder:map 标签的 issue，只写四件事：目标（Destination）、备注、已定的决策、尚未明确与超出范围。它不存细节，只指向持有细节的票据——一个决策只存在于一个地方，地图永远只给一句话摘要加链接。
2. 四种票据类型 —— 每张票据都是地图的子 issue，按"要不要人在场"分 HITL 和 AFK 两类：**研究（research，AFK）**查文档、查第三方 API 找出某个决策在等的事实；**原型（prototype，HITL）**做个粗糙但具体的样品供人反应；**追问（grilling，HITL）**是默认类型，靠对话澄清；**任务（task）**是"不先干完就没法做决定"的杂活，比如先开通服务才能评判它的 API。
3. 迷雾战与前沿（Fog of war & frontier） —— 它不预先切分看不清的部分：还说不精确的问题留在"尚未明确"，说得精确的立刻开成票据。没有任何未闭合阻塞、也没人认领的开放票据构成"前沿"，也就是此刻真正能动的那条边界；每解决一张票据，前方的雾就散开一点，新的票据随之浮现。

常见问题

wayfinder 和普通的任务清单有什么区别？

TODO 列表装的是"要做的事"，它装的是"要先定的事"。这个技能的产出默认是决策而不是交付物——票据被解决，意味着一个决定被记录、一个疑问被查清，而不是一段代码被写完。只有当"执行"本身是通往下一个决策的必经之路时，才会以任务票据的形式出现。

用 wayfinder 需要预先准备什么？

需要一个 issue tracker：地图、子票据、阻塞关系、前沿查询都落在 tracker 上，原生依赖关系让"现在能做什么"在 tracker 自己的界面里就能看出来；如果没提供 tracker，它会退回到本地 Markdown 方案。另外，HITL 类票据（原型、追问）必须由真人参与，agent 不会替你回答你自己那一侧的问题——一个自问自答的追问流程，就已经破坏了这个技能的前提。

一次会话能处理几张票据？

一次会话只解决一张票据，research 票据除外，后者可以派子智能体并行查。调用方式有两种：刚有模糊想法时"画地图"，把目标和当前说得清的票据一次建好，然后停手；或者拿着已有的地图"逐张推进"，你不指定就由它按顺序取前沿上的第一张。注意，如果画地图时发现根本没什么迷雾（整件事一次会话就能干完），它不会硬造一张地图，而是停下来问你打算怎么办。