用途:nav-onboard 是 Navigator 的交互式上手技能,让用户通过完成真实任务来学习工作流,而非只读文档。当用户说“onboard me”“teach me Navigator”“how do I use Navigator”“Navigator tutorial”“learn Navigator”“new to Navigator”“what skills should I use”“help me get started with Navigator”,或首次在 init 后使用 Navigator 时自动触发。若用户询问某个具体技能、已完成上手(.agent/onboarding/.completed 存在)或明确要求跳过,则不应触发。
主要能力:提供两条学习路径。快速入门约15分钟,含4个核心技能动手练习并生成个性化工作流指南;完整教育约45分钟,含理念入门(上下文效率原则)、全部5个核心技能练习、项目专属开发技能与完整工作流掌握。核心技能包括 nav-start(高效开始会话)、nav-marker(保存进度检查点)、nav-task(记录构建内容)、nav-sop(沉淀可复用解决方案)、nav-compact(清理上下文而不丢失工作)。
使用方式:先检查是否已完成上手,再运行项目分析器 python3 skills/nav-onboard/functions/project_analyzer.py 检测技术栈,运行 python3 skills/nav-onboard/functions/skill_recommender.py 生成技能推荐,随后让用户选择 Q(快速)或 F(完整)路径。初始化进度:mkdir -p .agent/onboarding 并运行 python3 skills/nav-onboard/functions/progress_tracker.py init [flow_type] [project_type]。逐个执行学习任务,用 python3 skills/nav-onboard/functions/task_validator.py [skill_name] 校验,用 python3 skills/nav-onboard/functions/progress_tracker.py update [skill_name] completed "[notes]" 更新进度。全部完成后运行 python3 skills/nav-onboard/functions/workflow_generator.py 生成 .agent/onboarding/MY-WORKFLOW.md,并以 touch .agent/onboarding/.completed 标记完成。
适用场景:新用户首次使用 Navigator、需要快速上手或系统学习工作流、希望获得项目专属技能推荐与个性化工作流指南。
限制:需先运行 nav-init 初始化 Navigator,否则提示先初始化。上手过程中创建的是真实文件(非沙盒),可事后删除;进度跨会话保留,可随时重跑(会询问是否覆盖)。每个学习任务设计为3-5分钟。若任务校验失败,可选择重试、跳过或仍标记完成。具体收费、价格与平台信息暂未提供。