nav-workflow

用途

nav-workflow（任务模式技能）用于统一编排 Navigator 中的多种工作流系统。资料指出，Navigator 原本存在三套互不相连的工作流：技能自带的迷你流程（步骤 1 到步骤 7）、循环模式（INIT 到 COMPLETE 阶段）以及 CLAUDE.md 中无人强制执行的工作流记录，多个系统同时运行时会冲突。任务模式作为协调者，判断何时应由技能接管流程、何时提供独立的阶段引导。

主要能力

自动检测任务复杂度，决定是否启用任务模式。
检测请求是否匹配已有技能，匹配则交由该技能处理，避免重复开销。
对规模较大且无匹配技能的任务，按 RESEARCH（研究）、PLAN（计划）、IMPL（实施）、VERIFY（验证）、COMPLETE（完成）五个阶段执行。
显示阶段切换与完成情况指示。
与循环模式、nav-simplify、自主完成协议等机制配合。

使用方式

触发条件：用户开始需要 3 步以上的较大工作时；没有明显匹配的技能时；请求涉及规划、重构或多文件改动时；循环模式关闭但仍需结构化执行时。

不触发的情况：琐碎任务（如修正拼写、单行修改）；技能会明确接管的任务（组件创建、端点添加、数据库迁移等）；用户声明“快速”“直接做”“简单修复”；已处于任务模式或循环模式中。

具体步骤：

分析请求，运行复杂度检测：

python3 functions/complexity_detector.py \
  --request "{USER_REQUEST}" \
  --context "{RECENT_CONTEXT}"

复杂度信号包括多文件改动（+0.3）、规划类语言（+0.2）、需求模糊需调研（+0.2）、跨系统改动（+0.3）、提及测试（+0.1）；简单信号包括单文件（-0.3）、修复或拼写类语言（-0.2）、给出具体位置（-0.2）、提及“快速”“简单”（-0.3）。得分低于阈值则直接执行，退出任务模式。

检查技能匹配：

python3 functions/skill_detector.py \
  --request "{USER_REQUEST}" \
  --available-skills "{SKILLS_LIST}"

若匹配到技能且配置允许，则显示“将由某技能处理”并退出任务模式。

若为较大任务且无技能匹配，初始化任务模式并展示阶段列表。
依次执行各阶段：研究阶段用任务代理探索代码库、识别受影响文件与既有模式；计划阶段建立待办项、确定改动顺序；实施阶段按计划修改并按需写测试；验证阶段运行测试、类型检查、构建校验，并在启用时运行 nav-simplify；完成阶段提交改动、更新文档、关闭工单（若配置了项目管理）、建议压缩上下文。
展示完成摘要，包括各阶段耗时、改动文件数、新增测试数、提交哈希。

阶段切换可用以下命令生成显示：

python3 functions/phase_indicator.py \
  --phase "IMPL" \
  --status "in_progress" \
  --progress 60 \
  --details '{"files_changed": 3, "tests_written": 2}'

配置

在 .agent/.nav-config.json 中设置：

{
  "task_mode": {
    "enabled": true,
    "auto_detect": true,
    "defer_to_skills": true,
    "complexity_threshold": 0.5,
    "show_phase_indicator": true
  }
}

各选项含义：enabled 为总开关；auto_detect 控制是否自动检测复杂度；defer_to_skills 决定是否让匹配技能处理自身流程；complexity_threshold 为激活阈值（0-1）；show_phase_indicator 控制是否显示阶段横幅。

适用场景

需要多步骤完成的功能开发。
重构类任务，例如将认证系统从会话改为 JWT。
涉及多文件、跨前后端的改动。
需要结构引导但不需要严格迭代控制的工作。

与循环模式的区别：循环模式提供严格迭代控制、停滞检测和退出信号，适合“一直运行到完成”的自主迭代；任务模式只提供阶段引导和技能协调，无严格关卡。两者可共存，循环模式可包裹任务模式阶段。将 defer_to_skills 设为 false 可强制始终使用任务模式的阶段。

限制

资料未提供该技能的安装命令、收费方式、支持平台及实际效果评估信息。配置缺失时使用默认值（auto_detect=true、阈值 0.5）；技能检测失败时回退到任务模式；阶段判断不明确时默认当前或下一逻辑阶段并向用户说明。

技能介绍

用途

主要能力

使用方式

配置

适用场景

限制