252 lines
5.0 KiB
Markdown
252 lines
5.0 KiB
Markdown
---
|
||
description: 任务执行流程。基于 task-spec.md 执行任务，包含流程设计、迭代实现、验证交付、文档更新和收尾。
|
||
---
|
||
|
||
# Aide 任务执行
|
||
|
||
你正在执行 Aide 任务执行流程。本流程基于任务细则（task-spec.md）完成实际的任务实施。
|
||
|
||
## 流程概览
|
||
|
||
```
|
||
流程设计 → 迭代实现 → 验证交付 → 文档更新 → 收尾
|
||
```
|
||
|
||
## 运行特点
|
||
|
||
- **完整闭环**：包含状态记录、git 提交、流程校验
|
||
- **可追溯**：每个步骤都有记录，支持中断恢复
|
||
- **自动化**：状态管理和版本控制通过 aide 程序处理
|
||
|
||
## 前置条件
|
||
|
||
确认存在 `task-spec.md`：
|
||
- 存在：读取并理解任务细则
|
||
- 不存在：提示用户先执行 `/aide:prep` 或提供任务细则
|
||
|
||
---
|
||
|
||
## 环节 1：流程设计
|
||
|
||
### 1.1 启动任务
|
||
|
||
执行命令开始新任务：
|
||
```bash
|
||
aide flow start flow-design "开始任务: <任务简述>"
|
||
```
|
||
|
||
### 1.2 理解任务细则
|
||
|
||
仔细阅读 `task-spec.md`：
|
||
- 明确任务目标和成功标准
|
||
- 理解执行步骤和依赖关系
|
||
- 识别技术决策和约束
|
||
|
||
### 1.3 分析项目环境
|
||
|
||
根据任务需要：
|
||
- 阅读相关代码文件
|
||
- 了解项目结构和约定
|
||
- 识别需要修改的模块
|
||
|
||
### 1.4 制定执行计划
|
||
|
||
产出执行计划，包含：
|
||
- 具体的实现步骤
|
||
- 每个步骤的预期产出
|
||
- 步骤间的依赖关系
|
||
- 潜在风险和应对方案
|
||
|
||
> 复杂任务建议使用 sequential-thinking 进行结构化规划
|
||
|
||
### 1.5 完成流程设计
|
||
|
||
记录步骤推进：
|
||
```bash
|
||
aide flow next-step "流程设计完成，计划 N 个实现步骤"
|
||
```
|
||
|
||
---
|
||
|
||
## 环节 2：迭代实现
|
||
|
||
### 2.1 进入实现环节
|
||
|
||
```bash
|
||
aide flow next-part impl "开始迭代实现"
|
||
```
|
||
|
||
### 2.2 按计划执行
|
||
|
||
对于每个实现步骤：
|
||
|
||
1. **执行前**：明确本步骤目标
|
||
2. **执行中**：自由发挥，完成实际编码/修改
|
||
3. **执行后**：记录完成
|
||
```bash
|
||
aide flow next-step "<本步骤完成的内容简述>"
|
||
```
|
||
|
||
### 2.3 处理问题
|
||
|
||
遇到问题时：
|
||
|
||
**一般问题（可继续）**：
|
||
```bash
|
||
aide flow issue "<问题描述>"
|
||
```
|
||
记录后继续执行，后续解决。
|
||
|
||
**严重错误（阻塞）**：
|
||
```bash
|
||
aide flow error "<错误描述>"
|
||
```
|
||
必须先解决再继续。处理方式：
|
||
1. 尝试自行解决（最多3次）
|
||
2. 成功：在 `discuss/` 创建分析文档记录解决过程
|
||
3. 失败：停止并告知用户
|
||
|
||
### 2.4 需要回退时
|
||
|
||
发现设计问题需要回退：
|
||
```bash
|
||
aide flow back-part flow-design "发现 xxx 问题，需要调整设计"
|
||
```
|
||
|
||
步骤内小回退：
|
||
```bash
|
||
aide flow back-step "<回退原因>"
|
||
```
|
||
|
||
---
|
||
|
||
## 环节 3：验证交付
|
||
|
||
### 3.1 进入验证环节
|
||
|
||
```bash
|
||
aide flow next-part verify "开始验证交付"
|
||
```
|
||
|
||
### 3.2 对照任务细则验证
|
||
|
||
逐项检查 `task-spec.md` 中的成功标准：
|
||
- 每个标准是否满足
|
||
- 每个交付物是否完成
|
||
- 功能是否正常工作
|
||
|
||
### 3.3 执行测试
|
||
|
||
根据项目情况：
|
||
- 运行已有测试套件
|
||
- 手动测试关键功能
|
||
- 验证边界情况
|
||
|
||
### 3.4 记录验证结果
|
||
|
||
```bash
|
||
aide flow next-step "验证完成: <验证结论>"
|
||
```
|
||
|
||
验证失败时：
|
||
- 记录失败原因
|
||
- 回退到实现环节修复
|
||
- 修复后重新验证
|
||
|
||
---
|
||
|
||
## 环节 4：文档更新
|
||
|
||
### 4.1 进入文档环节
|
||
|
||
```bash
|
||
aide flow next-part docs "开始文档更新"
|
||
```
|
||
|
||
### 4.2 更新相关文档
|
||
|
||
根据任务影响更新：
|
||
- `README.md`（如有用户可见变更）
|
||
- `CHANGELOG.md`（记录本次变更）
|
||
- 其他相关文档
|
||
|
||
### 4.3 CHANGELOG 更新规范
|
||
|
||
在 `CHANGELOG.md` 中：
|
||
1. 在 `[Unreleased]` 区块添加本次变更
|
||
2. 使用语义化分类（Added/Changed/Fixed/Removed）
|
||
3. 简明描述变更内容
|
||
|
||
### 4.4 记录完成
|
||
|
||
```bash
|
||
aide flow next-step "文档更新完成"
|
||
```
|
||
|
||
---
|
||
|
||
## 环节 5：收尾
|
||
|
||
### 5.1 进入收尾环节
|
||
|
||
```bash
|
||
aide flow next-part finish "开始收尾"
|
||
```
|
||
|
||
### 5.2 清理工作
|
||
|
||
- 删除临时文件和调试代码
|
||
- 确保代码格式规范
|
||
- 检查是否有遗漏的 TODO
|
||
|
||
### 5.3 最终检查
|
||
|
||
确认：
|
||
- 所有计划步骤已完成
|
||
- 所有测试通过
|
||
- 文档已更新
|
||
- 仓库状态干净
|
||
|
||
### 5.4 完成任务
|
||
|
||
```bash
|
||
aide flow next-step "任务完成"
|
||
```
|
||
|
||
### 5.5 向用户汇报
|
||
|
||
总结本次任务：
|
||
- 完成了什么
|
||
- 主要变更点
|
||
- 遗留问题（如有）
|
||
- 后续建议（如有）
|
||
|
||
---
|
||
|
||
## 错误恢复机制
|
||
|
||
### ⚠ 警告级别
|
||
|
||
- 记录问题：`aide flow issue "<描述>"`
|
||
- 分析是否影响继续
|
||
- 可继续：记录"继续-xxx"
|
||
- 需解决：记录"待解决-xxx"
|
||
|
||
### ✗ 错误级别
|
||
|
||
- 记录错误：`aide flow error "<描述>"`
|
||
- 必须解决后才能继续
|
||
- 尝试自行解决（最多3次）
|
||
- 成功：在 `discuss/` 创建分析文档
|
||
- 失败：停止并告知用户
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. **状态同步**：每个步骤变化都要通过 `aide flow` 记录
|
||
2. **原子提交**：aide flow 会自动处理 git add 和 commit
|
||
3. **业务自由**：编写业务代码时自由发挥，不受格式约束
|
||
4. **简体中文**：所有输出和记录使用简体中文
|
||
5. **可恢复**：任务中断后可通过状态记录恢复进度
|