SuperAPI AI 工具集

nav-task

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:为 Navigator 项目创建和管理任务文档,即记录“构建了什么、如何构建、为什么这样构建”的实现计划,作为规划工具、进度跟踪、历史记录和知识库。

调用时机:用户说“document this feature”“archive this task”“create task doc for...”“document what I built”,或完成/开始功能并提及 done、finished、create implementation plan 等。不适用于查询已有任务、创建 SOP(应使用 nav-sop)或更新系统文档。

主要能力:1) 确定任务 ID:用户提供则直接使用,否则读取 .agent/.nav-config.json 的 task_prefix 并查看 .agent/tasks/*.md 生成下一个编号;2) 区分创建(开始功能,生成空模板)与归档(功能完成,从对话生成实现记录);3) 创建模板含上下文、成功标准、分阶段实现计划、技术决策、依赖、完成清单;4) 归档模板含构建摘要、实现阶段、技术决策表、修改文件、挑战与解决方案、测试、文档、相关工作;5) 归档前做 ToM 检查点,向用户展示提取内容并请其确认或更正;6) 更新 .agent/DEVELOPMENT-README.md 索引;7) 若配置了 Linear 或 GitHub 等 PM 工具则添加评论。

使用方式:任务文档保存到 .agent/tasks/TASK-{XX}-{slug}.md。文件命名遵循 TASK-{XX}-{slug}.md,slug 应具描述性(如 oauth-implementation)。归档时分析最近 30-50 条消息。PM 工具为 GitHub 时可用 gh issue comment {ISSUE-NUMBER} -b 添加评论。

适用场景:开始超过一天的重大功能、完成任何功能需归档、复杂实现需记录决策;不建议用于微小缺陷修复或方向未明的探索性工作。

限制与错误处理:未初始化时提示先运行 /nav:init;任务 ID 已存在时提供读取、换 ID、覆盖选项;上下文不足归档时提示补充信息或手动创建。技能附带 generate_task.py 和 update_index.py 脚本辅助生成文档与更新索引。该技能与 /nav:doc feature 命令功能相同,但使用自然语言调用。