用途:当想法太大、无法在一次智能体会话内完成,且从当前到目的地的路径尚不清晰时,Wayfinder 负责“找路”而非直接冲向目的地。它把路线绘制为仓库 issue tracker 上的共享地图,然后逐张处理决策票据(其解决结果是决策,而非待执行的构建切片),直到路线清晰。
主要能力:地图是 issue tracker 上的单个 issue,标签为 wayfinder:map,票据是其子 issue。地图只做索引,记录已做决策并链接到持有细节的票据。票据正文是问题,大小适配一次 100K token 的智能体会话,并带 wayfinder:<type> 标签,类型包括 research(AFK)、prototype(HITL)、grilling(HITL)、task(HITL 或 AFK)。阻塞使用 tracker 原生依赖关系,以便在 UI 中可视化前沿;前沿是开放、未阻塞、未被认领的子票据。会话通过先分配给自己来认领票据。地图含 Destination、Notes、Decisions so far、Not yet specified、Out of scope 等部分。
使用方式:两种模式。绘制地图:用户以模糊想法调用,先命名目的地(调用 Skill 工具的 grilling 与 domain-modeling),再广度优先梳理前沿,创建地图与可指定的票据,第二遍连接阻塞边,并为 research 票据并行启动子智能体(在一次性 research/<name> 分支上捕获发现,推送但不合并 PR)。推进地图:用户以地图 URL 或编号调用,加载低分辨率视图,选择并认领票据,按标签类型解决,记录解决评论、关闭 issue、追加到 Decisions so far,并毕业新可指定的迷雾。每会话最多解决一张票据,research 票据除外。
适用场景:工程工作、课程内容等任何符合该形状的领域;目的地可以是待交接迭代的规格、规划前要锁定的决策,或就地进行的变更(如数据结构迁移)。
限制:默认只规划不执行,产出决策而非交付物;除非在 Notes 中覆盖。HITL 票据必须与真人实时交流解决,智能体不得代替人类一方。地图刻意不完整,不绘制尚不可见的内容。若未提供 issue tracker,需让用户运行 /setup-matt-pocock-skills,否则默认使用 local-markdown tracker。具体 tracker 操作见其文档的 Wayfinding operations 部分。