⚡

NavigatorOnboardingSkill nav-onboard

这是一个交互式、实践导向的入职培训技能，帮助用户通过完成实际任务来学习Navigator的工作流程，适用于前端、后端和全栈项目。

DevOps 0 次安装 0 次浏览 更新于 3/4/2026

Navigator Onboarding Skill

交互式、动手学习体验，用于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后初始化

不要调用如果：

  • 用户询问特定技能（调用该技能代替）
  • 用户已完成入职培训（.agent/onboarding/.completed存在）
  • 用户明确要求跳过入职培训

两个学习流程

快速开始（约15分钟）

对于想要快速提高生产力的用户：

  • 4个基本技能与动手实践
  • 生成个性化工作流程指南
  • 最少的哲学，最多的实践

全面教育（约45分钟）

对于想要全面理解的用户：

  • 哲学入门（上下文效率原则）
  • 所有5个基本技能与实践
  • 项目特定的开发技能
  • 完整的工作流程掌握

执行步骤

第1步：检查之前的入职培训

if [ -f ".agent/onboarding/.completed" ]; then
  echo "COMPLETED"
else
  echo "NOT_COMPLETED"
fi

如果已完成：询问用户是否想要重新进行入职培训或仅查看他们的工作流程指南。

第2步：分析项目

运行项目分析器以检测技术栈：

python3 skills/nav-onboard/functions/project_analyzer.py

输出结构：

{
  "project_name": "my-app",
  "project_type": "fullstack",
  "frontend_framework": "Next.js",
  "backend_framework": "Express",
  "database": "PostgreSQL",
  "testing_framework": "Jest",
  "has_navigator": true
}

第3步：生成技能推荐

基于项目分析运行技能推荐器：

python3 skills/nav-onboard/functions/skill_recommender.py

输出结构：

{
  "essential_skills": ["nav-start", "nav-marker", "nav-task", "nav-sop", "nav-compact"],
  "recommended_skills": ["frontend-component", "backend-endpoint"],
  "optional_skills": ["visual-regression", "product-design"],
  "workflow_order": ["nav-start", "nav-task", "frontend-component", "nav-sop", "nav-marker", "nav-compact"]
}

第4步：展示流程选择

显示检测结果并询问用户选择流程：

Navigator Onboarding

我已经分析了你的项目：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
项目：[project_name]
类型：[project_type]
技术栈：[tech_stack]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

根据你的项目，我推荐这些技能：

基本技能（所有项目）：
  1. nav-start     - 有效启动会话
  2. nav-marker    - 保存进度检查点
  3. nav-task      - 记录你构建的内容
  4. nav-sop       - 捕获解决方案以供重用
  5. nav-compact   - 在不丢失工作的情况下清除上下文

对于你的[project_type]项目：
  6. [recommended_skill_1] - [description]
  7. [recommended_skill_2] - [description]

选择你的学习路径：

[Q] 快速开始（约15分钟）
    学习4个基本技能与动手实践
    立即提高生产力

[F] 全面教育（约45分钟）
    完成Navigator掌握
    哲学+所有相关技能+实践

你的选择 [Q/F]：

第5步：初始化进度跟踪

创建入职目录和进度文件：

mkdir -p .agent/onboarding

# Run progress_tracker.py init
python3 skills/nav-onboard/functions/progress_tracker.py init [flow_type] [project_type]

创建.agent/onboarding/PROGRESS.md：

# Navigator Onboarding Progress

**Started**: [date]
**Flow**: Quick Start | Full Education
**Project**: [name] ([type])

---

## Essential Skills

| # | Skill | Status | Completed | Notes |
|---|-------|--------|-----------|-------|
| 1 | nav-start | pending | - | - |
| 2 | nav-marker | pending | - | - |
| 3 | nav-task | pending | - | - |
| 4 | nav-sop | pending | - | - |
| 5 | nav-compact | pending | - | - |

## Development Skills

| # | Skill | Status | Completed | Notes |
|---|-------|--------|-----------|-------|
| 6 | [skill] | pending | - | - |

---

**Progress**: 0/[total] (0%)
**Next Task**: nav-start

*Last Updated: [timestamp]*

第6步：执行学习任务

对于课程中的每个技能，遵循这个模式：

6.1：展示任务

读取学习任务文件并展示给用户：

cat skills/nav-onboard/learning-tasks/[task-file].md

以这种格式展示：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TASK [N]/[TOTAL]: [Skill Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[任务描述和上下文]

DO THIS NOW：
━━━━━━━━━
类型："[exact command to type]"

WHAT SHOULD HAPPEN：
━━━━━━━━━━━━━━━━━━━
[预期输出描述]

准备好了吗？输入上面的命令，然后说"done"完成。

6.2：等待用户操作

用户输入命令（例如，“Start my Navigator session”）。

相关技能自动执行。

用户说"done"或类似的话准备继续。

6.3：验证完成

运行任务验证器：

python3 skills/nav-onboard/functions/task_validator.py [skill_name]

每个技能的验证检查：

  • nav-start：用户确认（会话显示）
  • nav-marker：文件存在于.agent/.context-markers/
  • nav-task：文件存在于.agent/tasks/
  • nav-sop：文件存在于.agent/sops/
  • nav-compact：.active文件在.context-markers/中创建

6.4：更新进度

python3 skills/nav-onboard/functions/progress_tracker.py update [skill_name] completed "[notes]"

6.5：展示进度并继续

✅ 任务完成：[skill_name]

进度：[N]/[TOTAL] ([percentage]%)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[进度条可视化]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


PRO TIP：
[Skill-specific best practice]

接下来：[next_skill_name]

继续吗？[Y/n]

第7步：生成个性化工作流程

所有任务完成后，生成工作流程指南：

python3 skills/nav-onboard/functions/workflow_generator.py

创建.agent/onboarding/MY-WORKFLOW.md：

  • 项目特定的工作流程图
  • 日常工作流程清单
  • 所有技能触发器的快速参考表
  • 用户栈的最佳实践

第8步：完成总结

标记入职培训完成并显示总结：

touch .agent/onboarding/.completed
echo "[date]" > .agent/onboarding/.completed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎉 NAVIGATOR ONBOARDING COMPLETE!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

你已经学会了：
✅ nav-start     - 有效启动会话
✅ nav-marker    - 保存进度检查点
✅ nav-task      - 记录实现
✅ nav-sop       - 捕获解决方案
✅ nav-compact   - 管理上下文
✅ [dev skills]  - 构建[project_type]功能

你的个性化工作流程：
📄 .agent/onboarding/MY-WORKFLOW.md

快速参考：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| 动作              | 说这个                          |
|---------------------|----------------------------------|
| 开始会话       | "Start my Navigator session"     |
| 保存进度       | "Create checkpoint [name]"       |
| 记录功能    | "Create task doc for [feature]"  |
| 捕获解决方案    | "Create SOP for [issue]"         |
| 清除上下文       | "Clear context and preserve"     |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

接下来怎么办？
1. 开始你的第一个真实会话："Start my Navigator session"
2. 保持MY-WORKFLOW.md作为参考
3. 在休息前创建标记
4. 记录你构建的内容

编码愉快！🚀

学习任务参考

基本技能（所有项目）

顺序 技能 任务文件 用户做什么 验证
1 nav-start 01-nav-start.md “Start my Navigator session” 会话摘要显示
2 nav-marker 02-nav-marker.md “Create checkpoint learning-test” 文件在.context-markers/中
3 nav-task 03-nav-task.md “Create task doc for learning-feature” 文件在.agent/tasks/中
4 nav-sop 04-nav-sop.md “Create SOP for learning-debugging” 文件在.agent/sops/中
5 nav-compact 05-nav-compact.md “Clear context and preserve markers” .active文件创建

开发技能（项目特定）

项目类型 技能 任务文件
前端 frontend-component 06-frontend-component.md
前端 frontend-test 07-frontend-test.md
后端 backend-endpoint 06-backend-endpoint.md
后端 backend-test 07-backend-test.md
全栈 前端+后端技能 顺序

快速开始课程

仅任务1-4：

  1. nav-start (3分钟)
  2. nav-marker (3分钟)
  3. nav-task (4分钟)
  4. 一个与项目匹配的开发技能 (5分钟)

总计：约15分钟

全面教育课程

第一部分：哲学（5分钟）

  • 阅读.agent/philosophy/CONTEXT-EFFICIENCY.md
  • 理解Navigator存在的原因
  • 关键原则：按需加载你需要的内容

第二部分：会话管理（10分钟）

  • 任务1：nav-start
  • 任务2：nav-marker
  • 任务5：nav-compact

第三部分：文档（10分钟）

  • 任务3：nav-task
  • 任务4：nav-sop

第四部分：开发技能（15-20分钟）

  • 项目特定技能
  • 动手实践真实的组件/端点

第五部分：总结（5分钟）

总计：约45分钟

预定义函数

project_analyzer.py

扩展nav-init/functions/project_detector.py：

  • 项目类型分类（前端/后端/全栈）
  • 数据库检测
  • 测试框架检测
  • Navigator状态检查

skill_recommender.py

将项目分析映射到技能推荐：

  • 基本技能（总是包括）
  • 推荐技能（基于项目类型）
  • 可选技能（高级功能）
  • 工作流程顺序（建议顺序）

progress_tracker.py

管理.agent/onboarding/PROGRESS.md：

  • 初始化进度文件
  • 更新任务状态
  • 计算完成百分比
  • 确定下一个任务

task_validator.py

验证任务完成：

  • 文件存在检查
  • 内容验证
  • 用户确认提示

workflow_generator.py

生成.agent/onboarding/MY-WORKFLOW.md：

  • 项目特定的工作流程
  • 日常清单
  • 快速参考表
  • 最佳实践

错误处理

Navigator未初始化

⚠️  本项目中未初始化Navigator。

先运行nav-init，然后回到入职培训。

你想现在初始化Navigator吗？[Y/n]

任务验证失败

⚠️  无法验证任务完成。

预期：[应该存在的内容]
发现：[实际发现的内容]

选项：
1. 重试任务
2. 跳过此任务
3. 标记为完成

你的选择 [1-3]：

用户想要跳过

跳过[skill_name]。

注意：你可以随时通过说：
"Teach me [skill_name]"来学习这个技能

继续下一个任务...

成功标准

入职培训成功时：

  • [ ] 用户完成了至少3个基本技能任务
  • [ ] .agent/onboarding/PROGRESS.md显示进度
  • [ ] .agent/onboarding/MY-WORKFLOW.md生成
  • [ ] .agent/onboarding/.completed标记创建
  • [ ] 用户知道如何开始会话和保存进度

注释

  • 入职培训期间创建的实际文件（非沙盒）
  • 如果不需要，以后可以删除创建的文件
  • 跨会话进度持续
  • 可以随时重新运行入职培训（询问是否覆盖）
  • 学习任务设计为每个3-5分钟