nav-task-mode

用途

任务模式（nav-task-mode）是 Navigator 中的统一工作流编排技能，用于协调三类可能冲突的机制：各专用技能内置的小型工作流、Loop Mode 的独立阶段系统，以及文档中约定但无人强制执行的工作流。其目标是在任务较复杂时给出结构化执行路径，同时在简单任务或已有技能可处理的场景下避免额外开销。

主要能力

复杂度自动检测：调用 functions/complexity_detector.py，根据请求与上下文给出 0 到 1 的复杂度分数，并返回信号与建议。资料列出的加分信号包括预期多文件改动（+0.3）、规划类措辞（+0.2）、需求模糊需调研（+0.2）、跨系统改动（+0.3）、提及测试要求（+0.1）；减分信号包括单文件（-0.3）、修复/拼写/更新类措辞（-0.2）、给出具体位置（-0.2）、出现“quick”或“simple”（-0.3）。
技能匹配检测：调用 functions/skill_detector.py，在给定可用技能列表时判断是否应由某个技能接管，返回匹配技能、置信度、触发词与是否让位。资料举例：“创建组件”匹配 frontend-component，“添加端点”匹配 backend-endpoint，“数据库迁移”匹配 database-migration，“写测试”匹配 backend-test/frontend-test。
阶段化执行：当任务较复杂且无匹配技能时，按 RESEARCH（理解需求，探索代码库、识别受影响文件与既有模式）、PLAN（建立待办项、确定改动顺序）、IMPL（按项目模式执行改动）、VERIFY（运行测试、类型检查、构建校验，并可在启用时运行 nav-simplify）、COMPLETE（提交、更新文档、按配置关闭工单）依次推进。
阶段指示器：调用 functions/phase_indicator.py 生成阶段切换与进度展示块。
配置可调：在 .agent/.nav-config.json 中设置 task_mode 的 enabled、auto_detect、defer_to_skills、complexity_threshold（默认 0.5）、show_phase_indicator。

使用方式

技能内包含的命令示例：

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

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

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

流程上先做复杂度分析，分数低于阈值则直接执行并退出任务模式；若匹配到技能且配置为让位，则提示该技能将处理并退出；否则显示激活信息，按阶段执行并在每阶段结束时展示切换提示，最后输出完成汇总（改动文件数、新增测试数、提交标识等）。

适用场景

适合预期三步以上、无明确技能对应、涉及规划/重构/多文件改动的任务；也适合 Loop Mode 关闭但仍需结构化执行的场景。不适合拼写修正、单行改动等琐碎任务，不适合已有明确技能能处理的请求，也不适合用户明确要求“快速”“直接做”“简单修复”的情况，以及已处于任务模式或 Loop Mode 时。

与其它机制的关系

与 Loop Mode 相比，任务模式更轻量：Loop Mode 有严格迭代控制、停滞检测和退出信号，任务模式只提供阶段引导与技能协调；两者可共存，Loop Mode 可包裹任务模式的阶段。默认让位给技能（defer_to_skills 为 true），置为 false 可强制始终使用任务模式阶段。nav-simplify 在 VERIFY 阶段、测试通过后、提交前运行，并遵循 simplification.enabled 配置。COMPLETE 阶段可触发自主完成协议：提交、归档文档、关闭工单、创建标记。

限制与缺失信息

资料未提供该技能本身的安装方式、版本、收费模式、支持的平台与运行环境要求，这些内容暂未提供。资料中的复杂度权重、阈值与脚本返回字段均为其自述说明，实际表现暂未提供独立验证信息。