用途:当一个松散想法大到超出单个智能体会话、且前路仍被迷雾笼罩时,Wayfinder 负责找路而非直接冲终点。它把路线画成仓库问题追踪器上的共享地图,再逐条解决决策工单(其解决结果是决策,而非可执行的构建切片),直到路线清晰。目的地因事而异,命名目的地是画图的第一步,它决定每张工单的范围,可能是要交接的规格、规划前要锁定的决策,或就地完成的改动(如数据结构迁移)。地图与领域无关。
主要能力:默认只规划不执行,工单解决决策,地图完成的标准是路线清晰、无需再定;每条工单控制在单个 10 万 token 会话内。地图是追踪器上带 wayfinder:map 标签的单一 issue,工单是其子 issue。地图是索引而非仓库,只列已做决策并链接承载细节的工单。工单类型:research(AFK,读文档、第三方 API 或本地知识库)、prototype(HITL,做粗糙可反应的产物)、grilling(HITL,对话,默认类型)、task(HITL 或 AFK,为解锁决策而必须先做的杂事)。用原生阻塞关系表达依赖,开放、未阻塞、未认领的子工单构成前沿;认领方式为先指派给自己。地图包含目的地、备注、已做决策、尚未明确(战争迷雾,范围内但还说不清的问题)、超出范围四部分。
使用方式:两种模式,每次会话不得解决超过一条工单(research 工单除外)。一是画地图:用户以松散想法调用,先命名目的地,再广度优先展开前沿,创建地图与可明确工单并二次连线阻塞关系,为 research 工单并行派发子智能体,随后停止。二是推进地图:用户以地图 URL 或编号调用,工单可选;加载地图低分辨率视图,选择并认领工单,解决后在 issue 上发布解决评论、关闭并在地图「已做决策」追加指针,再把新浮现的工单创建并连线,把已可明确化的迷雾升级为工单。若未提供追踪器,提示用户运行 /setup-agent-skills,否则默认使用本地 markdown 追踪器。称呼一律用名称,不裸用编号或 slug。
适用场景:工程工作、课程内容等任何符合该形态的大块工作规划。
限制:官方资料未提供收费、价格、平台、效果等信息;每条工单仅覆盖单会话规模,画图本身是一次会话的工作,不直接解决工单。