80ebbd4的任务收尾
This commit is contained in:
@@ -139,16 +139,75 @@ aide config get task.source
|
||||
|
||||
**必须执行**：
|
||||
|
||||
##### 简单/中等任务
|
||||
|
||||
1. 根据分析结果生成任务细则文档
|
||||
2. 保存到配置的路径：
|
||||
```bash
|
||||
aide config get task.spec
|
||||
```
|
||||
3. **强制确认点**：
|
||||
- 向用户展示细则摘要
|
||||
- 使用 AskUserQuestion 询问用户是否确认
|
||||
- 等待用户明确答复后才能继续
|
||||
- 如用户有修改意见，更新细则后重新确认
|
||||
|
||||
##### 复杂任务（需拆分为子计划）
|
||||
|
||||
1. 获取计划文档目录：
|
||||
```bash
|
||||
aide config get task.plans_path
|
||||
```
|
||||
2. 创建目录（如不存在）
|
||||
3. 生成以下文档：
|
||||
|
||||
**任务计划总导览（guide.md）**：
|
||||
|
||||
```markdown
|
||||
# 任务计划总导览
|
||||
|
||||
## 任务简述
|
||||
[一句话描述任务目标]
|
||||
|
||||
## 子计划列表
|
||||
|
||||
| # | 名称 | 状态 | 细则文档 |
|
||||
|---|------|------|----------|
|
||||
| 1 | [子计划1名称] | pending | spec-01.md |
|
||||
| 2 | [子计划2名称] | pending | spec-02.md |
|
||||
...
|
||||
|
||||
## 执行顺序
|
||||
[说明子计划之间的依赖关系和执行顺序]
|
||||
|
||||
## 备注
|
||||
[其他需要说明的内容]
|
||||
```
|
||||
|
||||
**各子计划细则（spec-01.md, spec-02.md, ...）**：
|
||||
|
||||
```markdown
|
||||
# 子计划 N：[名称]
|
||||
|
||||
## 目标
|
||||
[具体目标]
|
||||
|
||||
## 具体步骤
|
||||
1. [步骤1]
|
||||
2. [步骤2]
|
||||
...
|
||||
|
||||
## 验证标准
|
||||
- [标准1]
|
||||
- [标准2]
|
||||
|
||||
## 依赖
|
||||
- 前置：[依赖的子计划，如无则写"无"]
|
||||
- 后续：[依赖本计划的子计划，如无则写"无"]
|
||||
```
|
||||
|
||||
##### 强制确认点
|
||||
|
||||
无论简单还是复杂任务：
|
||||
- 向用户展示细则摘要
|
||||
- 使用 AskUserQuestion 询问用户是否确认
|
||||
- 等待用户明确答复后才能继续
|
||||
- 如用户有修改意见，更新细则后重新确认
|
||||
|
||||
```bash
|
||||
aide flow next-step "任务细则已确认"
|
||||
@@ -303,10 +362,67 @@ aide flow next-part docs "验证通过，进入文档环节"
|
||||
aide flow next-step "文档更新完成"
|
||||
```
|
||||
|
||||
### 阶段 6：收尾 (finish)
|
||||
### 阶段 6：用户确认 (confirm)
|
||||
|
||||
```bash
|
||||
aide flow next-part finish "文档更新完成，进入收尾"
|
||||
aide flow next-part confirm "文档更新完成，进入用户确认环节"
|
||||
```
|
||||
|
||||
#### 6.1 向用户报告完成信息
|
||||
|
||||
汇总已完成的工作：
|
||||
- 列出主要变更点
|
||||
- 说明验证结果
|
||||
- 提供关键文件清单
|
||||
|
||||
#### 6.2 等待用户确认
|
||||
|
||||
**用户可能的操作**：
|
||||
|
||||
1. **确认通过** → 直接进入 finish
|
||||
2. **发现问题** → 进入返工流程
|
||||
|
||||
#### 6.3 返工流程
|
||||
|
||||
当用户发现问题或有新需求时：
|
||||
|
||||
##### 分析问题类型
|
||||
|
||||
| 问题类型 | 返工阶段 | 说明 |
|
||||
|----------|----------|------|
|
||||
| 实现问题 | impl | 代码逻辑错误、功能不符预期 |
|
||||
| 设计问题 | flow-design | 架构或流程设计有误 |
|
||||
| 需求问题 | task-optimize | 需求理解偏差、新增需求 |
|
||||
|
||||
##### 返工前必须操作
|
||||
|
||||
**必须**在返工前完成以下操作：
|
||||
|
||||
1. **更新任务文档（task.source）**：
|
||||
- 记录用户反馈的问题
|
||||
- 补充新发现的需求或要求
|
||||
- 这是为了便于上下文中断后恢复
|
||||
|
||||
2. **更新任务计划文档**：
|
||||
- 简单任务：更新 `task.spec`
|
||||
- 复杂任务：更新相应的子计划文档（`spec-NN.md`）
|
||||
|
||||
```bash
|
||||
aide flow next-step "更新任务文档，准备返工"
|
||||
```
|
||||
|
||||
##### 执行返工
|
||||
|
||||
```bash
|
||||
aide flow back-part <目标阶段> "返工原因: <简述>"
|
||||
```
|
||||
|
||||
从目标阶段继续执行，直到再次到达 confirm 阶段。
|
||||
|
||||
### 阶段 7：收尾 (finish)
|
||||
|
||||
```bash
|
||||
aide flow next-part finish "用户确认通过，进入收尾"
|
||||
```
|
||||
|
||||
- 清理临时文件
|
||||
@@ -379,32 +495,59 @@ aide config get task.spec
|
||||
|
||||
对于拆分为多个子计划的复杂任务：
|
||||
|
||||
### 文档结构
|
||||
|
||||
复杂任务的文档存放在 `task.plans_path` 配置的目录下（默认 `.aide/task-plans/`）：
|
||||
|
||||
```
|
||||
.aide/task-plans/
|
||||
├── guide.md # 任务计划总导览
|
||||
├── spec-01.md # 子计划 1 细则
|
||||
├── spec-02.md # 子计划 2 细则
|
||||
└── spec-NN.md # 子计划 N 细则
|
||||
```
|
||||
|
||||
### 执行模式
|
||||
|
||||
```
|
||||
task-optimize → [flow-design → impl → verify → docs] × N → finish
|
||||
task-optimize → [flow-design → impl → verify → docs → confirm] × N → finish
|
||||
```
|
||||
|
||||
> 注：每个子计划完成 docs 后需经过 confirm 阶段，用户确认后才进入下一个子计划
|
||||
|
||||
### 流程
|
||||
|
||||
1. 完成 task-optimize，生成任务导览和所有子计划细则
|
||||
1. 完成 task-optimize：
|
||||
- 生成 `guide.md`（任务计划总导览）
|
||||
- 生成所有 `spec-NN.md`（子计划细则）
|
||||
2. 对每个子计划：
|
||||
- 进入 flow-design，为该子计划设计流程图
|
||||
- 进入 impl，实现该子计划
|
||||
- 进入 verify，验证该子计划
|
||||
- 进入 docs，更新该子计划相关文档
|
||||
- 标记子计划完成，更新任务导览
|
||||
- 进入 confirm，等待用户确认
|
||||
- 用户确认后，更新 `guide.md` 中该子计划状态为 `completed`
|
||||
3. 所有子计划完成后，进入 finish
|
||||
|
||||
### 子计划切换
|
||||
|
||||
完成一个子计划的 docs 后：
|
||||
完成一个子计划的 confirm 后：
|
||||
|
||||
```bash
|
||||
aide flow next-step "子计划 N 完成，开始子计划 N+1"
|
||||
aide flow back-part flow-design "开始下一个子计划的流程设计"
|
||||
```
|
||||
|
||||
### 子计划状态管理
|
||||
|
||||
每完成一个子计划，更新 `guide.md` 中的状态表：
|
||||
|
||||
| # | 名称 | 状态 | 细则文档 |
|
||||
|---|------|------|----------|
|
||||
| 1 | [子计划1名称] | **completed** | spec-01.md |
|
||||
| 2 | [子计划2名称] | **in_progress** | spec-02.md |
|
||||
| 3 | [子计划3名称] | pending | spec-03.md |
|
||||
|
||||
---
|
||||
|
||||
## 附录：任务复杂度评估指导原则
|
||||
|
||||
@@ -252,6 +252,7 @@ aide flow show 2025-12-15T17-28-53
|
||||
| `impl` | 迭代实现 | exec 阶段使用 |
|
||||
| `verify` | 验证交付 | exec 阶段使用 |
|
||||
| `docs` | 文档更新 | exec 阶段使用 |
|
||||
| `confirm` | 用户确认 | 审阅与返工 |
|
||||
| `finish` | 收尾 | exec 阶段使用 |
|
||||
|
||||
### 流程校验
|
||||
@@ -452,6 +453,9 @@ aide init
|
||||
├── diagrams/ # 流程图目录
|
||||
│ ├── *.puml # PlantUML 源文件
|
||||
│ └── *.png # 生成的图片
|
||||
├── task-plans/ # 复杂任务计划文档（可配置）
|
||||
│ ├── guide.md # 任务计划总导览
|
||||
│ └── spec-NN.md # 子计划细则
|
||||
└── project-docs/ # 项目文档（面向 LLM）
|
||||
├── README.md # 总导览
|
||||
├── block-plan.md # 区块计划
|
||||
@@ -498,8 +502,14 @@ aide flow next-step "验证完成: 所有测试通过"
|
||||
aide flow next-part docs "验证通过，进入文档环节"
|
||||
aide flow next-step "文档更新完成"
|
||||
|
||||
# 9. 收尾
|
||||
aide flow next-part finish "文档更新完成，进入收尾"
|
||||
# 9. 进入用户确认
|
||||
aide flow next-part confirm "文档更新完成，进入用户确认环节"
|
||||
# 等待用户确认...
|
||||
# 如用户确认通过：
|
||||
aide flow next-step "用户确认通过"
|
||||
|
||||
# 10. 收尾
|
||||
aide flow next-part finish "用户确认通过，进入收尾"
|
||||
aide flow next-step "任务完成"
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user