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