用途
nav-onboard 是 Navigator 的入门引导技能，面向刚接触 Navigator 的用户，目标是通过实际操作帮助用户掌握 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”等语句时触发；首次使用 Navigator 完成 init 后也可使用。若用户询问某个具体技能、已完成过引导（存在 .agent/onboarding/.completed）或明确要求跳过引导，则不应触发。
主要能力
- 两条学习路径：快速入门（Quick Start，约15分钟，包含4个核心技能实操，并生成个性化工作流指南）与完整教育（Full Education，约45分钟，包含上下文效率理念介绍、全部5个核心技能实操、项目相关开发技能及完整工作流掌握）。
- 项目分析：运行 project_analyzer.py 检测项目名称、类型（frontend/backend/fullstack）、前端框架、后端框架、数据库、测试框架及是否已安装 Navigator。
- 技能推荐：运行 skill_recommender.py 输出核心技能、推荐技能、可选技能及建议工作流顺序。
- 进度跟踪：通过 progress_tracker.py 管理 .agent/onboarding/PROGRESS.md，初始化进度、更新任务状态、计算完成百分比、确定下一任务。
- 任务验证：通过 task_validator.py 检查文件存在性、内容及用户确认。
- 工作流生成：通过 workflow_generator.py 生成 .agent/onboarding/MY-WORKFLOW.md，包含项目专属工作流图、每日工作清单、技能触发速查表及适用于用户技术栈的最佳实践。
使用方式
执行步骤依次为：检查是否存在 .agent/onboarding/.completed（如已完成则询问用户是重新引导还是查看工作流指南）；运行项目分析器检测技术栈；运行技能推荐器；展示检测结果并让用户选择快速入门或完整教育；初始化进度跟踪（mkdir -p .agent/onboarding 并运行 progress_tracker.py init）；按课程逐项呈现学习任务，用户输入指定命令、相关技能自动执行后说“done”，再运行 task_validator.py 验证并更新进度；全部完成后运行 workflow_generator.py 生成个性化工作流；最后创建 .completed 标记并展示完成摘要与速查表。
核心技能任务：nav-start（启动会话）、nav-marker（创建检查点）、nav-task（为功能编写任务文档）、nav-sop（为问题沉淀 SOP）、nav-compact（清理上下文并保留标记）。开发技能任务根据项目类型选择 frontend-component、frontend-test、backend-endpoint、backend-test 等。
适用场景
适用于 Navigator 新用户的首次上手、希望快速了解核心技能并立即投入使用的用户，以及希望完整理解上下文效率理念与完整工作流的用户。也适用于引导中随时跳过后通过“Teach me [skill_name]”补充学习单个技能。
限制与注意事项
- 若 Navigator 尚未初始化，会提示先运行 nav-init。
- 引导过程中创建的是真实文件（非沙箱），之后可自行删除；进度跨会话持久保存；可随时重新运行引导（会询问是否覆盖）。
- 任务验证失败时提供重试、跳过或仍标记完成三种选项。
- 每个学习任务设计时长约3-5分钟。
- 成功标准包括：至少完成3个核心技能任务、PROGRESS.md 显示进度、生成 MY-WORKFLOW.md、创建 .completed 标记、用户掌握启动会话与保存进度的方法。
- 具体安装命令与插件路径依赖用户环境中的 CLAUDE_PLUGIN_ROOT 或本地插件缓存目录，资料未提供更多安装细节。