用途:Wayfinder 用于规划超出单次 agent 会话容量、且路线尚不明确的大块工作。它不直接冲向目的地,而是把工作绘制为 Issue 跟踪器上的共享地图,逐个解决其中的决策 ticket,直到路线清晰。
主要能力:地图是带 wayfinder:map 标签的 issue,ticket 是其子 issue。地图包含目的地、笔记、已有决策、尚未明确、范围外等章节,只做索引并链接到 ticket,不重述细节。ticket 分 research、prototype、grilling、task 四类,分别对应 AFK 研究、HITL 原型、对话盘问和纯手动任务。阻塞关系使用跟踪器原生依赖,前沿即打开的、未阻塞的、未分配的子 issue。
使用方式:两种模式。绘制地图时,先命名目的地,再广度优先盘问绘制前沿,创建地图与可明确的 ticket,并启动 research 子代理;绘制地图本身不解决 ticket。推进地图时,加载地图、选择并认领 ticket、按其类型解决、记录解决结果并升级迷雾内容。每个会话最多解决一个 ticket(research 除外)。
适用场景:工程工作、课程内容等任何形态的规划;目标可以是规格、决策或原地变更。
限制:默认是规划工具,产出决策而非可交付物;HITL ticket 只能通过实时交流解决;地图故意不完整,不绘制尚不可见的内容;范围外内容永不毕业。若未提供跟踪器,默认使用本地 Markdown 跟踪器,否则提示用户运行 /setup-matt-pocock-skills。