SuperAPI AI 工具集

nav-start

编程与开发

查看项目

更新于 10-25 17:17

技能介绍

nav-start 是 Navigator 插件中的一个技能,旨在开发会话开始时加载 Navigator 文档导航器,以便以优化的上下文开始工作。根据资料,该技能应在以下情况调用:用户说“开始我的会话”、“开始工作”、“加载导航器”、“显示文档”、“我应该做什么工作?”、“恢复工作”、“继续我上次的地方”,或者询问项目结构或当前任务时。如果用户已经运行过 /nav:start 命令、Navigator 已经加载、或者用户正处于实现过程中,则不应调用。

执行流程包括:检测 SessionStart 钩子注入的哨兵字符串以走快速路径;检查 Navigator 版本并可选自动更新;检查项目是否已初始化 Navigator(需存在 .agent/DEVELOPMENT-README.md);读取文档导航器;检查活动上下文标记;读取配置并检查版本漂移;加载知识图谱和用户配置文件;检查项目管理工具中的任务;显示 OpenTelemetry 会话统计;最后显示 Navigator ASCII 标志和包含文档加载统计、工作流强制检查等信息的会话摘要。该技能还包含首次会话特性显示逻辑。

适用场景为使用 Navigator 进行开发的会话启动阶段,帮助开发者快速了解项目文档、任务和上下文,并遵循工作流。限制包括:需要项目已通过 /nav:init 初始化;部分功能(如知识图谱、用户配置文件、自动更新)依赖相应配置或文件存在;版本检查、自动更新、PM 工具检查等可能因环境或网络问题跳过;且不应在会话中途或已加载后重复调用。