SuperAPI AI 工具集

nitro-wayfinder

智能体与模型

查看项目

更新于 10-15 20:12

技能介绍

用途:当某个想法太大、单个 agent 会话做不完、且从当前到目标之间的路径还不清晰时,用 wayfinding 方法先找出路径,而不是直接冲向目标。做法是把想法画成一张由 nitro agent 任务组成的决策地图,再逐一处理其中的决策票据(其解决结果是决策,而非构建切片),直到没有待决事项,然后才切出实现任务。若未找到 nitro,说明 CLI 未安装:停止并让用户到 https://chillicream.com/docs/nitro/cli/installation 安装,不要自行安装。

主要原则:nitro agent 是唯一记忆,会话会结束或压缩,工作区会存活;每个决策只存在于一个已关闭票据中,地图只做索引。偏好写入 nitro agent memory,跨会话协调走 nitro agent mail。看板是工作记忆,进行中的 grill 逐条在票据上写进度评论。只规划不构建,构建始终在单独会话中从实现任务进行。每个会话只解决一个决策。地图是索引不是仓库,用 nitro agent tasks show <id> --output json 按需下钻。票据以标题引用、括号内附 id。HITL 票据必须由人解决,AFK 票据由 agent 独立驱动。

地图:一个类型为 epic、标签 wayfinder:map、标题为 Map: <effort> 的任务,描述含 Destination、Notes、Decisions so far、Not yet specified、For review、Out of scope;开放票据是它的子项,通过查询找到。决策票据为 --type question,任务票据为 --type task,各带一个标签:grilling(HITL,默认,编号问题加建议)、research(AFK,用 nitro-research 子代理)、prototype(HITL,一次性产物)、task(两种情况,只有为解除某决策阻塞才成立)。阻塞用原生依赖;前沿即开放的、无阻塞、未被认领的子票据。答案在解决时以评论记录并关闭票据。地图刻意不完整:尚无法精确表述的写入 Not yet specified,超出目标范围的记入 Out of scope。

调用:两种模式都先做会前清理(取规划者角色、处理未读邮件、加载该工作的记忆)。

画地图:地图是本会话第一笔写入,先于第一个提问;由想法创建地图并建两个 wayfinder:grilling 票据「Name the destination」与「Map the frontier」(后者依赖前者)。先统一提问风格并存为偏好。解决第一个票据直到目标能用两行说清;解决第二个广度优先地铺开前沿,逐条建票据、写迷雾。若没有迷雾且一次会话可完成,则关闭地图并询问用户如何继续。

推进地图(next):加载地图与记忆,启动前沿上的 research 票据,按优先级取票据并认领,先读评论以续接半完成的 grill,记录解决结果并追加到 Decisions,再做毕业处理(新建票据、提升迷雾、关闭失效票据、明确排除范围),然后结束会话。其他会话可能并行工作,编辑前重新加载地图。

到达目标:无开放票据且 Not yet specified 为空时路径清晰,切出实现任务图并写设计文档到 .nitro/designs/,再以理由关闭地图。

注意:决策票据开始产出交付物说明该区域已完成,应停止并交接;无上下文的问题会被拒;HITL 票据不得独自解决。具体命令与模板见 references 下各文件。资料未涉及收费、价格或平台支持范围。