SuperAPI AI 工具集

learn-projects

通用与其它

查看项目

更新于 10-15 08:16

技能介绍

用途

Learn Projects 是 Nexus 的入门引导(onboarding)技能,目标是教会用户 Nexus 项目(projects)如何运作。它通过具体示例和决策框架,帮助用户理解何时应该创建项目、何时应该创建技能,以及项目如何组织与推进。

该技能被标记为高优先级的主动建议技能。当用户配置中 learning_tracker.completed.learn_projects 为 false 时,AI 会在以下情形主动建议学习:

  • 用户第一次说「create project」时(建议先学习再创建)
  • 用户描述的工作听起来像一个项目(有交付物、截止日期、有限的工作量)
  • 用户询问如何组织工作、跟踪进度或管理任务
  • 用户对「项目」与「技能」的区别感到困惑
  • 用户开始创建多个相似的「项目」(反模式检测)
  • 在 setup-goals 或 setup-workspace 结束时(自然的下一步)
  • 显示 Nexus 菜单且 total_projects = 0 时

建议话术示例:在创建第一个项目之前,是否愿意花约 8 分钟了解 Nexus 项目如何运作,内容包括何时使用项目与技能、项目结构与生命周期、如何有效跟踪进度。用户可以说「learn projects」开始,或说「skip」直接创建项目。

以下情况不会建议:learning_tracker.completed.learn_projects 已为 true;用户明确表示「直接创建项目」或「跳过教程」;用户已成功创建过项目。

主要能力

该技能通过示例与决策框架讲解以下内容:

  1. 具体示例:区分什么是项目、什么不是项目。

    • 是项目:为客户提案、研究竞争对手并撰写分析、为新员工创建入职文档。
    • 不是项目(属于技能):生成每周状态报告(重复)、筛选潜在客户(重复)、格式化文档(重复)。
    • 核心规律:项目会结束,技能会重复。
  2. 决策框架:

    • 问题一:这是方向还是工作?方向 = 目标(goals.md);工作 = 项目或技能。
    • 问题二:它会重复吗?不重复 → 项目(有终点);重复 → 技能(可复用)。
    • 反模式示例:不要创建「weekly-report-week-1」「weekly-report-week-2」等,而应创建一个「weekly-report」技能每周使用。
  3. 项目结构:

    📁 02-projects/05-client-proposal/
    ├── 01-planning/
    │   ├── overview.md    # 是什么与为什么
    │   ├── plan.md        # 怎么做
    │   └── steps.md       # 任务(复选框)
    ├── 02-resources/      # 参考资料
    ├── 03-working/        # 进行中的工作
    └── 04-outputs/        # 最终交付物
    
  4. 生命周期:规划(PLANNING)→ 进行中(IN_PROGRESS)→ 完成(COMPLETE)→ 归档(ARCHIVED)。

  5. 练习:让用户说出 3 件计划要做的事,一起套用决策框架并解释理由。

  6. 如何创建项目:说「create project for [描述]」或「new project: [名称]」。

使用方式

用户说「learn projects」即可启动该技能。技能按以下工作流推进:

  • 步骤 1:展示具体示例,并询问用户计划做什么工作,一起分类。
  • 步骤 2:套用决策框架(方向还是工作?会重复吗?)。
  • 步骤 3:介绍项目文件夹结构。
  • 步骤 4:讲解生命周期各状态。
  • 步骤 5:练习,让用户列出 3 件事并共同分类。
  • 步骤 6:说明创建项目的方式。
  • 步骤 7:收尾,在 user-config.yaml 中标记完成:
    learning_tracker:
      completed:
        learn_projects: true  # ADD THIS LINE
    
    并展示完成信息,提示后续可选操作(create project、learn skills、learn nexus),以及结束时说「done」保存进度。

预计耗时 8-10 分钟。

适用场景

适合刚接触 Nexus、尚未创建过项目、或对项目与技能区别不清楚的用户。也适合在完成目标或工作区设置后,作为自然的下一步学习内容。

限制

该技能是引导教程,不负责实际创建项目;创建项目需使用「create project」等指令。其主动建议行为依赖 user-config.yaml 中的 learning_tracker.completed.learn_projects 状态。关于收费、价格、平台支持范围等信息,资料中暂未提供。