nav-task

用途

nav-task 是 Navigator 工具集中的技能，用于管理任务文档，包括创建实现计划、归档已完成任务以及更新任务索引。它帮助团队把功能开发过程中的目标、做法与原因记录下来，形成可长期查阅的实现记录。

创建新任务文档：当用户开始新功能时，生成空白的实现计划模板，包含背景、验收标准、实现阶段、范围外事项、技术决策、验证与完成确认等部分。
归档已完成任务：当功能完成时，分析最近约 30 至 50 条对话消息，整理出实际构建内容、实现阶段、文件修改、技术决策、遇到的问题与解决方案、测试与文档情况。
任务 ID 管理：若用户提供任务 ID 则直接使用；否则读取 .agent/.nav-config.json 中的 task_prefix，并检查已有任务文件后生成下一个编号，例如 TASK-06。
知识召回：在创建流程中，若存在 .agent/knowledge/graph.json，可调用 memory_recall.py 查询相关知识图谱记忆，将召回的经验作为“已知陷阱与模式”章节纳入模板。
知识图谱同步：存在知识图谱时，可通过 task_to_graph.py 将任务状态与概念写入图谱；已完成任务还可提取技术决策作为决策记忆。
PM 工具联动：若配置了 Linear 或 GitHub，可在对应 issue 上添加实现计划文档的评论。
索引更新：编辑 .agent/DEVELOPMENT-README.md，将任务加入活动任务索引。

该技能通过自然语言触发。开始新功能时说“为某功能创建任务文档”“创建实现计划”；完成功能时说“记录这个功能”“归档这个任务”“我完成了……”。它会区分创建与归档两种流程：创建时生成模板，归档时从对话中提取实际实现内容并生成完整记录。

归档流程包含一次校验步骤，向用户展示提取出的功能摘要、关键决策、文件变更和解决的问题，确认无误后再写入文档。

任务文档保存至 .agent/tasks/TASK-{XX}-{slug}.md，并遵循包含状态、创建日期、完成日期等字段的模板结构。

不适用于微小缺陷修复（建议使用 SOP）、纯探索性工作、查询已有任务、创建 SOP 或更新系统文档。