9.4 KiB
9.4 KiB
/aide:run 命令设计文档
一、概述
/aide:run 是任务执行的核心命令，整合了任务准备和任务执行功能。
1.1 设计目标
| 目标 | 说明 |
|---|---|
| 统一入口 | 一个命令完成任务准备和执行 |
| 状态感知 | 自动检测 flow 状态，支持续接 |
| 复杂度适应 | 支持简单任务直接执行，复杂任务拆分子计划 |
1.2 与旧命令的关系
本命令整合了原 /aide:prep 和 /aide:exec 的功能。
二、执行流程
2.1 总体流程
┌─────────────────────────────────────────┐
│ /aide:run │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 强制触发 aide skill │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ aide flow status │
│ (检查当前 flow 状态) │
└─────────────────────────────────────────┘
│
┌──────────┴──────────┐
▼ ▼
[无活跃任务] [有活跃任务]
[或已 finish] [未完成]
│ │
▼ ▼
新任务流程 续接流程
2.2 新任务流程
┌─────────────────────────────────────────┐
│ task-optimize (任务准备) │
├─────────────────────────────────────────┤
│ 1. aide flow start task-optimize │
│ 2. 读取任务文档 │
│ 3. 任务分析 │
│ 4. 复杂度评估 │
│ 5. 任务优化 │
│ 6. 待定项处理（如有） │
│ 7. 生成任务细则 │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ flow-design (流程设计) │
├─────────────────────────────────────────┤
│ 1. aide flow next-part flow-design │
│ 2. 制定执行计划 │
│ 3. 创建流程图（PlantUML） │
│ 4. aide flow next-part impl │
│ (自动校验并生成 PNG) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ impl (迭代实现) │
├─────────────────────────────────────────┤
│ 按计划执行，每步记录： │
│ aide flow next-step "<完成内容>" │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ verify (验证交付) │
├─────────────────────────────────────────┤
│ 1. aide flow next-part verify │
│ 2. 对照任务细则验证 │
│ 3. 执行测试（如适用） │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ docs (文档更新) │
├─────────────────────────────────────────┤
│ 1. aide flow next-part docs │
│ 2. 更新 README、CHANGELOG 等 │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ finish (收尾) │
├─────────────────────────────────────────┤
│ 1. aide flow next-part finish │
│ 2. 清理临时文件 │
│ 3. 向用户汇报 │
└─────────────────────────────────────────┘
2.3 续接流程
┌─────────────────────────────────────────┐
│ 分析当前进度 │
├─────────────────────────────────────────┤
│ aide flow status │
│ aide flow show <task_id> │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 载入项目认知 │
├─────────────────────────────────────────┤
│ 调用 /aide:load 逻辑 │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 读取任务细则 │
├─────────────────────────────────────────┤
│ aide config get task.spec │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 从中断处继续执行 │
└─────────────────────────────────────────┘
三、复杂任务处理
3.1 复杂度评估
根据任务复杂度评估指导原则判断：
| 等级 | 特征 | 处理方式 |
|---|---|---|
| 简单 | 单文件或少量文件 | 直接执行 |
| 中等 | 2-4 个模块 | 直接执行 |
| 复杂 | 5+ 模块 | 拆分子计划 |
| 超大 | 10+ 模块 | 拆分独立任务 |
3.2 子计划执行模式
task-optimize
│
▼
[flow-design → impl → verify → docs] × N
│
▼
finish
每个子计划完成 docs 后，回退到 flow-design 开始下一个子计划。
四、职责边界
4.1 本命令负责
- 检查 flow 状态
- 任务分析和优化
- 复杂度评估和子计划拆分
- 待定项处理
- 流程设计和流程图创建
- 迭代实现
- 验证交付
- 文档更新
- 收尾汇报
4.2 本命令不负责
- 环境配置（由
/aide:setup负责） - 项目文档创建和维护（由
/aide:docs负责）
五、触发的 Skill
| Skill | 触发方式 | 用途 |
|---|---|---|
| aide | 强制触发 | 提供 aide 命令使用指南 |
六、相关文档
七、版本信息
- 创建日期：2025-12-15
- 整合原
/aide:prep和/aide:exec