SuperAPI AI 工具集

wayfinder

通用与其它

查看项目

更新于 10-15 23:25

技能介绍

用途:当有一个大到单个 agent 会话无法完成、且路径尚不清晰的构想时,Wayfinder 用于“找路”而非直接冲向目标。它是 /propose 之前的阶段:propose 假设已知工作形态,wayfinder 用于尚不清楚时。仅手动调用(disable-model-invocation: true)。

主要能力:在 issue ledger 上创建地图(标签 wayfinder:map)与子 ticket,并连接阻塞边;查询 frontier;对 HITL ticket 与用户实时对话;并行派发 research 子代理。地图包含 Destination、Decisions so far、Not yet specified(战争迷雾)、Out of scope 四部分,地图只作索引,细节存放在各 ticket 中。

ticket 类型:research(AFK,读文档/API 获取事实)、prototype(HITL,用粗糙原型提升讨论分辨率)、grilling(HITL,逐句对话,默认类型)、task(HITL 或 AFK,决策前必须完成的手工事项)。HITL ticket 只能通过真人交流解决,agent 不得替人回答。

使用方式:两种模式。Chart the map:用户带着模糊构想调用,先用 /grilling 与 /domain-modeling 确定 Destination,按广度绘制 frontier,创建地图与可钉住的 ticket,并行派发 research 子代理后停止,不自行解决 ticket。Work through the map:用户带着已有地图调用,加载地图,选择 ticket(用户指定或 frontier.py --map <id> 取第一个),先 claim 再解决,记录 resolution、关闭 issue(status: done)、追加 Decisions so far,并处理新 ticket、迷雾毕业与 out-of-scope。每个会话最多解决一个 ticket(research 除外)。

限制:不生成交付物;不替 HITL 的人回答;不把迷雾预先切成 ticket;不处理目标之外的工作。frontier 无迷雾时说明路径已清晰,应停止并询问用户;ticket 被他人 claim 时改选其他;HITL 无人应答则 blocked。ledger 是唯一事实来源,远程 tracker 只是镜像。