93d1b21的任务收尾

aide-marketplace/aide-plugin/skills/rework/SKILL.md

@@ -0,0 +1,165 @@
+# 返工流程指南
+
+本指南帮助你在 Aide 工作流中处理返工（rework）场景。返工是指用户在 confirm 阶段发现问题或有新需求，需要回退到之前的阶段重新处理。
+
+## 返工类型判断
+
+根据问题类型选择返工目标阶段：
+
+| 返工目标 | 触发条件 | 处理方式 |
+|----------|----------|----------|
+| task-optimize | 新需求、需求理解偏差 | 更新 task.source |
+| flow-design | 架构/流程设计问题 | 更新细则 + new-requirements.md |
+| impl | 实现问题 | 更新细则 + new-requirements.md |
+| verify | 验证未通过 | 更新细则 + new-requirements.md |
+
+---
+
+## 返工到 task-optimize 阶段
+
+当需要重新理解需求或有重大新需求时使用。
+
+### 流程
+
+1. 记录问题：
+   ```bash
+   aide flow issue "准备返工: [原因简述]"
+   ```
+
+2. 更新 task.source 文档（见下方格式）
+
+3. 向用户发出提醒（见下方模板）
+
+4. 执行返工命令：
+   ```bash
+   aide flow back-part task-optimize "[原因]"
+   ```
+
+5. 执行确认命令：
+   ```bash
+   aide flow back-confirm --key [key]
+   ```
+   > 注：key 由 `aide flow back-part` 生成
+
+### task.source 更新格式
+
+在文档末尾添加：
+
+```markdown
+---
+
+## 返工记录 [时间戳]
+
+### 用户反馈
+[用户原文]
+
+### 提出时机
+[在哪个阶段/步骤提出]
+
+### LLM 建议
+[如有]
+```
+
+---
+
+## 返工到其他阶段
+
+返工到 flow-design、impl、verify 阶段时使用。
+
+### 流程
+
+1. 记录问题：
+   ```bash
+   aide flow issue "准备返工前处理需求整合: [原因简述]"
+   ```
+
+2. 创建/更新 new-requirements.md（见下方格式）
+
+3. 更新细则文档：
+   - 在导览部分添加返工声明
+   - 梳理：已完成项、未完成项、需重新处理项
+   - 处理需求冲突
+   - 融入新需求
+   - 删除返工声明
+
+4. 向用户发出提醒（见下方模板）
+
+5. 执行返工命令：
+   ```bash
+   aide flow back-part [阶段] "[原因]"
+   ```
+
+6. 执行确认命令：
+   ```bash
+   aide flow back-confirm --key [key]
+   ```
+
+### new-requirements.md 格式
+
+位置：`.aide/new-requirements.md`
+
+```markdown
+# 新需求记录
+
+## 返工 [时间戳]
+
+### 用户反馈
+[原文]
+
+### 提出时机
+[阶段/步骤]
+
+### 影响分析
+- 已完成项：[列表]
+- 未完成项：[列表]
+- 需重新处理：[列表]
+
+### 冲突处理
+[如何处理与原细则的冲突]
+```
+
+---
+
+## 提醒用户模板
+
+### 返工到 task-optimize
+
+> 我将会对 task-now.md 进行更新，加入您的新需求和我的建议，然后更新流程状态返工到 task-optimize 阶段。建议您在流程状态返工后使用 `/exit` 结束本次对话，重新启动一个新的对话执行 load+run，我将会自动接续任务的处理。
+
+### 返工到其他阶段
+
+> 我将会对 new-requirements.md 进行更新，加入您的新需求和我的建议，然后处理好您的新需求和原细则的需求冲突整合，然后更新流程状态返工到 [阶段] 阶段。建议您在流程状态返工后使用 `/exit` 结束本次对话，重新启动一个新的对话执行 load+run，我将会自动接续任务的处理。
+
+---
+
+## 确认机制
+
+返工前必须完成确认流程：
+
+1. 当执行 `aide flow back-part` 时，系统会检测是否已确认
+2. 如未确认，系统会生成一个随机 key 并输出提示
+3. 完成准备工作后，执行 `aide flow back-confirm --key <key>` 确认
+4. 确认成功后，系统会自动执行返工操作并创建清洁提交
+
+### 命令说明
+
+```bash
+# 首次调用：生成 key，记录目标阶段
+aide flow back-part flow-design "设计遗漏"
+# 输出: ⚠ 返工需要确认。请先完成准备工作，然后执行:
+#       aide flow back-confirm --key abc123
+
+# 完成准备后：确认并执行
+aide flow back-confirm --key abc123
+# 输出: ✓ 返工确认成功，回退到环节: flow-design
+#       ⚠ 建议执行 /exit 重新开始对话
+```
+
+---
+
+## 注意事项
+
+1. **文档优先**：返工前必须更新相关文档，确保上下文不丢失
+2. **清洁提交**：确认后系统会自动创建 git 提交，保留当前状态
+3. **重启对话**：建议返工后重启对话，避免上下文混乱
+4. **状态文件**：确认状态存储在 `.aide/back-confirm-state.json`