用途
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 技能校验。
七步执行流程
- 初始化进度跟踪:创建包含所有工作流步骤的 TodoWrite。
- 加载项目上下文:运行
python 00-system/core/nexus-loader.py --project [project-id],再用 Read 工具并行读取推荐文件,并展示项目摘要。 - 识别当前阶段:解析任务文件,找出第一个未完成章节与下一个未完成任务,计算进度并展示当前状态,询问用户下一步。
- 持续跟踪执行工作:按章节执行,展示章节概览、逐任务执行、章节完成检查点,然后批量完成该章节:
python 00-system/skills/bulk-complete/scripts/bulk-complete.py --project [project-id] --section 3 --no-confirm,并展示更新后的进度。 - 增量进度更新:每个章节/检查点后展示进度条并询问用户下一步。
- 处理部分完成:用户暂停时,提供部分任务批量完成选项,例如
--tasks 20-25,随后触发 close-session。 - 项目完成:全部章节完成后进行最终验证,执行
--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 工具
- 具体收费、价格、平台支持等信息暂未提供