SuperAPI AI 工具集

execute-project

办公与效率

查看项目

更新于 10-15 08:14

技能介绍

用途

execute-project 是 Nexus 系统中用于与已有项目交互的唯一方式。当用户通过名称、ID 或编号引用任何项目时加载,适用于继续、恢复、查看状态、进度等场景。其核心价值是确保工作始终与计划任务保持一致,并持续提供进度可见性。

主要能力

  • 加载项目上下文(规划文件、当前进度)
  • 识别当前阶段/章节与下一个未完成任务
  • 系统化执行工作(按章节或按任务)
  • 使用 bulk-complete-tasks.py 持续更新任务完成状态
  • 在每个章节/检查点后验证进度
  • 优雅处理暂停与恢复
  • 完成后自动触发 close-session

使用方式

前置条件

  • 项目存在于 02-projects/ 且元数据有效
  • 规划文件存在:overview.md、plan.md(或 design.md)、steps.md(或 tasks.md)
  • 任务文件使用复选框格式:- [ ] Task description
  • 项目状态为 IN_PROGRESS 或 PLANNING

若前置条件不满足:缺少项目则先用 create-project 技能;缺少规划则先完成规划阶段;任务格式无效则用 validate-system 技能校验。

七步执行流程

  1. 初始化进度跟踪:创建包含所有工作流步骤的 TodoWrite。
  2. 加载项目上下文:运行 python 00-system/core/nexus-loader.py --project [project-id],再用 Read 工具并行读取推荐文件,并展示项目摘要。
  3. 识别当前阶段:解析任务文件,找出第一个未完成章节与下一个未完成任务,计算进度并展示当前状态,询问用户下一步。
  4. 持续跟踪执行工作:按章节执行,展示章节概览、逐任务执行、章节完成检查点,然后批量完成该章节:python 00-system/skills/bulk-complete/scripts/bulk-complete.py --project [project-id] --section 3 --no-confirm,并展示更新后的进度。
  5. 增量进度更新:每个章节/检查点后展示进度条并询问用户下一步。
  6. 处理部分完成:用户暂停时,提供部分任务批量完成选项,例如 --tasks 20-25,随后触发 close-session。
  7. 项目完成:全部章节完成后进行最终验证,执行 --all 批量完成,更新 overview.md 元数据状态为 COMPLETE,并触发 close-session。

关键脚本

  • nexus-loader.py --project [ID]:加载项目上下文
  • bulk-complete-tasks.py --project [ID] --section [N]:完成某章节
  • bulk-complete-tasks.py --project [ID] --tasks [range]:完成指定任务
  • bulk-complete-tasks.py --project [ID] --all:完成全部任务

适用场景

  • 用户说“execute project [ID/name]”“continue [project-name]”“work on [project-name]”
  • 编排器检测到项目继续(IN_PROGRESS 状态)
  • 需要按计划系统化推进项目并持续跟踪进度

高级特性

  • 自适应粒度:小项目(≤15 任务)逐任务执行;中型项目(16-30 任务,有章节)按章节执行并批量完成;大型项目(>30 任务,有章节)按章节执行并每 5-7 任务设检查点;无结构项目每 10 任务设检查点。
  • 心智模型集成:在关键决策点(章节完成、风险评估、设计选择)主动提供 2-3 个相关心智模型供用户选择,用户选定后再加载对应模型文件。
  • 引导感知:在项目执行期间,根据 user-config.yaml 中 learning_tracker.completed 的状态,在自然停顿处提供上下文学习建议(如 learn skills、learn integrations),但用户专注任务中、已明确拒绝或引导已完成时不建议。

限制

  • 依赖 Nexus 系统目录结构与脚本(00-system 等)
  • 需要项目已按规范创建并具备规划文件
  • 任务文件必须使用复选框格式
  • 批量完成脚本失败时回退到手动 Edit 工具
  • 具体收费、价格、平台支持等信息暂未提供