SuperAPI AI 工具集

wayfinder-plus

智能体与模型

查看项目

更新于 10-23 16:19

技能介绍

Wayfinder Plus 用于处理规模超出单个智能体会话、且路径尚不清晰的工作。它不直接冲向目标,而是先把通往目标的路线绘制成一张共享地图,再逐个解决地图上的决策工单,直到路线清晰。

用途与流程定位:它处在四步流水线的第一步——wayfinder-plus(找到路径)→ to-spec-plus(编写规格)→ to-tickets-plus(切分工单)→ implement-plus(每会话构建一个切片)。地图清晰后应交接给后续步骤,而不是直接开始构建;只有当工作确实很小时才可跳过规格直接进入工单切分。

地图与工单结构:地图是一个带 wayfinder:map 标签的单一 issue,是规范产物;其工单是地图的子 issue。地图本身是索引而非存储,只列出已完成决策并指向承载细节的工单,每个决策只存放在对应工单中。地图正文包含 Destination(目标)、Notes(领域、应查阅的技能、偏好)、Decisions so far(已完成决策索引)、Not yet specified(尚在迷雾中的范围内工作)、Out of scope(被排除的工作)。每张工单正文是需在一个会话内解决的一个问题,并带有 wayfinder:<type> 标签,类型为 research、prototype、grilling、task 之一。

认领与阻塞:会话开始工作前先把工单指派给驱动开发者以示认领,开放且未指派的工单视为未认领。阻塞关系优先使用跟踪器原生依赖(如 Linear blockedBy、GitHub issue dependencies),无原生支持时回退为正文中的 Blocked by 行。工单在所有阻塞项关闭后解除阻塞;前沿(frontier)即开放、未阻塞、未认领的子工单。

工单类型:research(AFK,由 research-plus 子代理查阅文档、源码、第三方 API 或内部知识库以获取决策所依赖的事实);prototype(HITL,用一次性原型工件提升讨论精度,如临时 Artisan 命令、Tinker 脚本、临时路由/Blade 视图、Livewire 组件或 Filament 页面);grilling(HITL,运行 grill-me-plus 结构化问答,一次一个决策,并配合 domain-modeling-plus 记录术语与 ADR);task(HITL 或 AFK,为决策扫清障碍的手动工作,如注册服务、开通权限、迁移数据)。

迷雾与范围:地图刻意不完整,不绘制尚不可见的内容。能精确陈述问题即建工单(即使被阻塞);无法精确表述则留在 Not yet specified。超出目标范围的工作进入 Out of scope,永不再毕业。

跟踪器解析:按顺序解析——若存在 docs/agents/issue-tracker.md 则遵循;若 AGENTS.md/CLAUDE.md 中有 Issue tracker 段则遵循;否则检测 Linear MCP 或 GitHub 远程加已认证 gh,都没有则使用 .scratch/ 下的本地 markdown。首次检测时用 AskUserQuestion 确认并可持久化。

调用方式:两种模式,每会话最多解决一个工单(research 工单除外)。绘制地图模式:用户给出松散想法,先通过 grill-me-plus 明确目标,再广度优先梳理前沿,创建地图与可指定的工单并在第二遍连接阻塞关系,并行启动 research 子代理,然后停止。推进地图模式:用户给出地图(URL、id 或路径),加载地图低分辨率视图,选择并认领前沿工单,按类型解决,记录决议并追加到 Decisions so far,补充新工单或毕业迷雾,最后打印流水线状态块并以名称引用地图和工单。