feat: 更新了command,上下文爆了

This commit is contained in:
2025-12-13 02:30:37 +08:00
parent e9c43fbb0e
commit 0bf9f7169f
3 changed files with 252 additions and 305 deletions

View File

@@ -1,251 +1,203 @@
---
description: 任务执行流程。基于 task-spec.md 执行任务,包含流程设计、迭代实现、验证交付、文档更新和收尾
description: 任务执行流程。基于任务细则执行任务,包含流程设计、迭代实现、验证交付、文档更新。
argument-hint: [任务细则文档路径]
---
# Aide 任务执行
你正在执行 Aide 任务执行流程。本流程基于任务细则task-spec.md完成实际的任务实施。
你正在执行 Aide 任务执行流程。基于任务细则完成实际的任务实施。
## 流程概览
## 参数
```
流程设计 → 迭代实现 → 验证交付 → 文档更新 → 收尾
```
## 运行特点
- **完整闭环**包含状态记录、git 提交、流程校验
- **可追溯**:每个步骤都有记录,支持中断恢复
- **自动化**:状态管理和版本控制通过 aide 程序处理
## 前置条件
确认存在 `task-spec.md`
- 存在:读取并理解任务细则
- 不存在:提示用户先执行 `/aide:prep` 或提供任务细则
- `$ARGUMENTS`:任务细则文档路径(可选)
- 未传入时使用配置中的默认路径
---
## 环节 1流程设计
## 开始
### 1.1 启动任务
### 确定任务细则
执行命令开始新任务:
```bash
aide flow start flow-design "开始任务: <任务简述>"
# 如果传入了参数
细则文档 = $ARGUMENTS
# 如果未传入参数,使用配置默认值
aide config get task.spec
```
### 1.2 理解任务细则
读取任务细则内容。如文档不存在,提示用户先执行 `/aide:prep` 或指定文档路径。
### 进入流程设计环节
```bash
aide flow next-part flow-design "进入流程设计环节"
```
---
## 环节 1流程设计 (flow-design)
### 理解任务细则
仔细阅读 `task-spec.md`
- 明确任务目标和成功标准
- 理解执行步骤和依赖关系
- 识别技术决策和约束
### 1.3 分析项目环境
### 分析项目环境
根据任务需要:
- 阅读相关代码文件
- 了解项目结构和约定
- 识别需要修改的模块
根据需要阅读相关代码/文档。
### 1.4 制定执行计划
### 制定执行计划
产出执行计划,包含:
- 具体的实现步骤
- 每个步骤的预期产出
- 步骤间的依赖关系
- 潜在风险和应对方案
> 复杂任务建议使用 sequential-thinking 进行结构化规划
### 1.5 完成流程设计
### 创建流程图(如需要)
在配置指定的流程图目录创建 PlantUML 源文件。
记录步骤推进:
```bash
aide flow next-step "流程设计完成,计划 N 个实现步骤"
aide flow next-step "流程设计完成"
```
> aide flow 会在此环节自动校验 PlantUML 语法
### 进入下一环节
```bash
aide flow next-part main "流程设计完成,进入实现环节"
```
> aide flow 会自动生成 PNG 流程图
---
## 环节 2迭代实现
## 环节 2迭代实现 (main)
### 2.1 进入实现环节
### 按计划执行
对于每个实现步骤,完成后记录:
```bash
aide flow next-part impl "开始迭代实现"
aide flow next-step "<完成内容简述>"
```
### 2.2 按计划执行
### 处理问题
对于每个实现步骤:
1. **执行前**:明确本步骤目标
2. **执行中**:自由发挥,完成实际编码/修改
3. **执行后**:记录完成
```bash
aide flow next-step "<本步骤完成的内容简述>"
```
### 2.3 处理问题
遇到问题时:
**一般问题(可继续)**
```bash
# 一般问题(可继续)
aide flow issue "<问题描述>"
```
记录后继续执行,后续解决。
**严重错误(阻塞)**
```bash
# 严重错误(需解决)
aide flow error "<错误描述>"
```
必须先解决再继续。处理方式:
严重错误处理:
1. 尝试自行解决最多3次
2. 成功:在 `discuss/` 创建分析文档记录解决过程
2. 成功:在 `discuss/` 创建分析文档
3. 失败:停止并告知用户
### 2.4 需要回退时
### 需要回退时
发现设计问题需要回退:
```bash
aide flow back-part flow-design "发现 xxx 问题,需要调整设计"
# 回退到上一步
aide flow back-step "<原因>"
# 回退到之前环节
aide flow back-part <环节名> "<原因>"
```
步骤内小回退:
### 进入下一环节
```bash
aide flow back-step "<回退原因>"
aide flow next-part verify "实现完成,进入验证环节"
```
---
## 环节 3验证交付
## 环节 3验证交付 (verify)
### 3.1 进入验证环节
### 对照任务细则验证
```bash
aide flow next-part verify "开始验证交付"
```
### 3.2 对照任务细则验证
逐项检查 `task-spec.md` 中的成功标准:
- 每个标准是否满足
- 每个成功标准是否满足
- 每个交付物是否完成
- 功能是否正常工作
### 3.3 执行测试
### 执行测试
根据项目情况
- 运行已有测试套件
- 手动测试关键功能
- 验证边界情况
根据项目情况运行测试或手动验证。
### 3.4 记录验证结果
### 记录结果
```bash
aide flow next-step "验证完成: <验证结论>"
```
验证失败时:
- 记录失败原因
- 回退到实现环节修复
- 修复后重新验证
验证失败时回退修复
```bash
aide flow back-part main "验证失败: <原因>"
```
### 进入下一环节
```bash
aide flow next-part docs "验证通过,进入文档环节"
```
---
## 环节 4文档更新
## 环节 4文档更新 (docs)
### 4.1 进入文档环节
> aide flow 会在进入此环节时提示更新 CHANGELOG
```bash
aide flow next-part docs "开始文档更新"
```
### 更新相关文档
### 4.2 更新相关文档
根据任务影响更新:
- `README.md`(如有用户可见变更)
- `CHANGELOG.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 "开始收尾"
aide flow next-part finish "文档更新完成,进入收尾"
```
### 5.2 清理工作
> aide flow 会校验 CHANGELOG 是否已更新
---
## 环节 5收尾 (finish)
### 清理工作
- 删除临时文件和调试代码
- 确保代码格式规范
- 检查是否有遗漏的 TODO
- 检查遗漏的 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. **可恢复**:任务中断后可通过状态记录恢复进度