80ebbd4的任务收尾

aide-marketplace/aide-plugin/commands/run.md

@@ -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 |
+
 ---
 
 ## 附录：任务复杂度评估指导原则