用途:nav-loop 用于让 AI 代理反复迭代执行同一任务,直到满足完成条件。当用户说“run until done”“keep going until complete”“iterate until finished”“autonomous mode”“loop mode”“don't stop until done”,或任务文档带有 loop_mode: true 时自动触发。单步任务、用户要求只做一次、已处于循环模式或用户禁用循环时不应触发。
主要能力:结构化 NAVIGATOR_STATUS 状态块、阶段自动识别(INIT → RESEARCH → IMPL → VERIFY → COMPLETE)、停滞检测(连续相同状态触发断路器)、双重退出闸门(启发式指标 + 显式 EXIT_SIGNAL)、迭代上限控制。完成指标包括代码已提交、测试通过、文档已更新、工单关闭、完成标记已创建。
使用方式:在 .agent/.nav-config.json 配置 loop_mode,字段包括 enabled、max_iterations(1-20)、stagnation_threshold(2-5)、exit_requires_explicit_signal、show_status_block。初始化使用命令 python3 functions/phase_detector.py --init;生成状态块使用 python3 functions/status_generator.py;停滞检测使用 python3 functions/stagnation_detector.py;退出判断使用 python3 functions/exit_gate.py。
限制:无法处理外部阻塞、主观完成标准或循环中需人工判断的任务;不建议用于快速修复、探索性工作或涉及安全审查的任务。资料未提供价格、平台和更多信息。