SuperAPI AI 工具集

nav-loop

智能体与模型

查看项目

更新于 10-25 17:17

技能介绍

用途

nav-loop 是 Navigator 技能体系中的循环执行技能,目的是让 AI 代理在无需人工反复催促的情况下,持续迭代执行任务,直到满足明确的完成条件。它适用于用户表达“跑到达成”“持续迭代直到完成”“自主模式”“循环模式”“不停直到完成”等意图,或任务文档中标记 loop_mode: true 的场景。单步任务、用户明确要求“只做一次”、已处于循环模式或用户禁用了循环模式时不触发。

主要能力

  • 结构化完成信号:每轮迭代后生成 NAVIGATOR_STATUS 状态块,显示当前阶段、迭代次数、进度百分比、完成指标勾选状态、退出条件满足情况、状态哈希与停滞计数。
  • 双条件退出门:退出需要同时满足启发式条件(至少 2 个完成指标)和显式 EXIT_SIGNAL。完成指标包括代码提交、测试通过、代码简化、文档更新、工单关闭、完成标记创建等。
  • 停滞检测与恢复:通过状态哈希比较识别连续相同状态。默认会暂停询问用户;可配置 never_pause_on_stagnation 为 true,实现自动多样化恢复,策略包括 combine(整合近失方案)、radical(大幅更换方案)、reread(重读任务文档寻找遗漏信号)。
  • 迭代间审批门:可配置 iteration_approval 为 none(不提示)、strict(每轮提示)、periodic(每 N 轮提示,N 由 periodic_interval 控制)。
  • 阶段自动检测:根据上下文自动判断 INIT、RESEARCH、IMPL、VERIFY、COMPLETE 阶段。
  • 最大迭代上限:通过 max_iterations(1-20)防止无限循环;启用自动多样化时必须显式设置上限。

使用方式

通过用户指令或任务文档触发循环模式。配置位于 .agent/.nav-config.json 的 loop_mode 字段,关键选项包括 enabled、max_iterations、stagnation_threshold、exit_requires_explicit_signal、show_status_block、iteration_approval、periodic_interval、never_pause_on_stagnation、stagnation_diversify_strategy。执行时先初始化循环状态,然后按阶段执行任务,每轮生成状态块,检查停滞,评估退出条件,达到最大迭代数时提示用户选择扩展、接受或中止。完成时输出 JSON 格式的退出信号,例如 {"v":2,"type":"exit","success":true,"reason":"All criteria met"},并执行自主完成协议(提交变更、归档文档、关闭工单、创建完成标记等)。

适用场景

  • 需要多轮修改、测试、验证的功能开发任务。
  • 修复缺陷并确保测试通过。
  • 在测试通过后自动进行代码简化与文档更新。
  • 夜间或无人值守的自主运行(需配置 never_pause_on_stagnation 与明确的 max_iterations)。

限制

  • 无法处理外部阻塞,如等待 API 或权限。
  • 无法处理主观完成标准(如“看起来好看”)。
  • 需要人工中途判断的任务不适用。
  • 自动多样化连续触发 3 次后会升级为中止路径。
  • 配置缺失时使用默认值(max_iterations=5,stagnation_threshold=3)。