用途:当某个事项超出单次 Agent 会话容量,且从当前状态到目的地的路线仍不清晰时,Wayfinder 不直接冲向目的地,而是在仓库内建立共享地图,把当前说得清的问题记录为决策票,逐张解决并推进前沿,直到路线清晰。目的地可以是可进入 to-prd 的完整决策、实施前必须锁定的关键选择,或需跨多轮确定路径的迁移。第一步始终是命名目的地。
主要能力:只规划不实施,每张决策票产出答案而非最终功能;当问题已变成明确的构建工作时,应交给 to-prd、to-api、to-task 或 impl,只有地图 Notes 明确要求边规划边执行时才纳入实施。使用本地 Markdown 布局:docs/scratch/<NN>-<中文需求名称>/ 下的 WAYFINDER.md 与 wayfinder/ 目录。WAYFINDER.md 是唯一权威地图,只作索引,包含 Destination、Notes、Decisions so far、Not yet specified、Out of scope;完整答案只存在于对应决策票,票内包含 Type、Status、Blocked by、Question、Resolution。票类型分 research(AFK)、prototype(HITL)、grilling(HITL)、task(HITL 或 AFK)。Blocked by 全部 resolved 后本票解除阻塞;前沿是全部 open 且已解除阻塞的票,按编号排序,工作时先改为 claimed,结束时写 Resolution 并改为 resolved。
使用方式:建图时命名目的地、广度优先扫描、创建地图与当前可描述票,建图会话不顺手解决 grilling、prototype 或 task 票。推进时只加载地图低分辨率视图,指定或选择前沿第一张票,认领后解决,写入答案并更新地图,再根据答案调整票与迷雾。两种模式都限制一次会话最多解决一张非 research 决策票。并发推进时每个执行上下文认领不同前沿票,只修改自己的票,地图索引需基于最新文件合并。
适用场景与限制:面向需要在多轮会话中逐步收敛路线的大型规划事务。地图故意不完整,只把当前能精确表述的问题建票;只能看见方向的内容留在 Not yet specified。费用、平台、效果等未提供。