SuperAPI AI 工具集

wayfinder

智能体与模型

查看项目

更新于 10-15 17:31

技能介绍

用途:Wayfinder 负责调查地图、持久前沿与不确定性路由,适用于目标庞大或模糊的规划阶段。它默认只规划,不执行目标,也不发明另一种工单格式。

主要能力:维护位于 docs/specs/<slug>.md 或 docs/specs/<slug>-wayfinder.md 的地图,包含唯一的 ## Artifact Graph 段、稳定 Artifact ID、Role: wayfinder,以及 Standalone: true 或一个带互惠 owner 边的 Parent。所有发出或消费的工单元数据遵循 canonical Ticket Envelope v1,序列化交由 to-tickets 或共享 CLI。工单存放于 docs/tickets/<spec-slug>/。

目的地门:目的地清晰时陈述假设并立即绘制地图,不做仪式化质询;若未解决答案会实质改变 Destination、范围或初始前沿,则调用 canonical grilling,分轮提问并等待确认,确认前不创建任何持久工件。已明确目的地但有未决决策时,不用内联访谈,而用 to-tickets 发出 execution_mode: HITL 的工单,其正文须要求质询与确认,并保持在前沿直至确认;不得为访谈状态新增 Ticket Envelope 字段。

流程:先重建足够上下文以识别目的地、决策、未知项、排除项和下一批阻塞边;再创建或更新地图各段(类型、状态、目的地、现有决策、尚未指定、超出范围、前沿/阻塞边、工单计划、下次评审)。持久决策经 to-spec 记录并在地图中链接。研究、原型、质询或任务工单经 to-tickets 创建,须写明问题/结果、证据、前沿、工作计划与排除项。使用工单的 mode、blockers、ID 前,先用共享 ticket-parse 命令解析既有工单,不得从 Blocked By 等标题推断这些字段。除非用户明确要求执行,否则停在地图;将单个就绪工单路由到 execute-ticket,文件夹路由到 ticket-autopilot;多人多会话遵循多会话工作规则。

维护:复用已确认的 Destination 与范围,除非用户显式更改或新证据会实质改变目的地、范围或初始前沿,否则不重启质询;发生此类变化须先回到目的地门再写持久更新。将已完成工单的证据与决策折回地图,移除已解决的未知项,保持前沿为下几条关键边,宁可再开调查工单也不猜测。最后报告地图路径、工单文件夹、就绪/阻塞前沿和建议的下一步。限制:仅规划,不执行;兼容性为显式开启;破坏性迁移、破坏外部契约和不可逆变更仍需标记;其它使用细节与收费情况暂未提供。