用途
Wayfinder 用于规划规模庞大、超出单个 Agent 会话处理能力的工作，尤其当从起点到目的地的路径尚不清晰时。它不直接执行工作，而是通过 issue tracker 上的共享地图，将工作分解为一系列需要解决的决策问题（票据）。
主要能力
- 地图与票据管理：创建一个标记为
wayfinder:map的 issue 作为地图，包含目的地、笔记、已做决策、未指定和范围外等部分；每个票据是地图的子 issue，包含待解决的问题或调查，并带有wayfinder:<type>标签。 - 票据类型：支持 research（AFK，通过子代理研究外部信息）、prototype（HITL，制作低保真原型辅助讨论）、grilling（HITL，通过对话逐个提问）和 task（HITL 或 AFK，完成解锁决策所需的手动工作）。
- 阻塞与前沿：使用 issue tracker 的原生依赖关系表示阻塞，未阻塞且未认领的开放子票据构成“前沿”，会话按顺序认领并解决。
- 战争迷雾：地图中的“未指定”部分记录能感知但尚无法精确表述的决策点；解决票据后，将变得可表述的内容毕业为新票据。
- 范围外管理：明确排除在目的地之外的工作记录在“范围外”部分，已存在的相关票据会被关闭并注明原因。
- 两种调用模式：绘制地图（从松散想法开始，确定目的地、梳理前沿、创建票据、并行启动研究子代理）；推进地图（加载地图，选择前沿票据，按类型解决，记录决策并更新地图）。
使用方式
- 绘制地图：用户以松散想法调用。先通过 grilling 确定目的地，再广度优先梳理前沿，创建地图和可指定的票据，连接阻塞关系，并为每个 research 票据启动子代理并行研究。
- 推进地图：用户以地图 URL 或编号调用，可选指定票据。加载地图后选择前沿票据，认领（分配给自己），按
wayfinder:<type>标签指定的方式解决，将答案作为解决评论发布并关闭 issue，更新地图的“已做决策”部分，添加新发现的票据，将迷雾中可指定的部分毕业，处理范围外情况。 - 并发：用户可并行运行未阻塞的票据，预期其他会话同时编辑 tracker。
适用场景
- 需要多轮会话才能明确方向的大型工程工作、课程内容或其他领域任务。
- 路径不清晰、需要先做决策再执行的项目。
- 需要与人类协作（HITL）或由 Agent 独立（AFK）完成的研究、原型或任务。
限制
- 默认只做规划，产出决策而非交付物，执行需另行安排；特定努力可在 Notes 中覆盖此默认，将执行纳入地图。
- 每个会话最多解决一个票据（research 票据除外）。
- 地图和票据的存储、阻塞和前沿查询依赖于 issue tracker 的具体实现；若未提供 tracker，默认使用本地 Markdown tracker。
- 目的地的具体形态因努力而异，需在绘制地图时首先确定。
- 关于收费、价格、平台等细节暂未提供。