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

返工流程指南

本指南帮助你在 Aide 工作流中处理返工（rework）场景。返工是指用户在 confirm 阶段发现问题或有新需求，需要回退到之前的阶段重新处理。

返工类型判断

根据问题类型选择返工目标阶段：

返工目标	触发条件	处理方式
task-optimize	新需求、需求理解偏差	更新 task.source
flow-design	架构/流程设计问题	更新细则 + new-requirements.md
impl	实现问题	更新细则 + new-requirements.md
verify	验证未通过	更新细则 + new-requirements.md

---

返工到 task-optimize 阶段

当需要重新理解需求或有重大新需求时使用。

流程

1. 记录问题：

   aide flow issue "准备返工: [原因简述]"
   

2. 更新 task.source 文档（见下方格式）

3. 向用户发出提醒（见下方模板）

4. 执行返工命令：

   aide flow back-part task-optimize "[原因]"
   

5. 执行确认命令：

   aide flow back-confirm --key [key]
   

   注：key 由 aide flow back-part 生成

task.source 更新格式

在文档末尾添加：

---

## 返工记录 [时间戳]

### 用户反馈
[用户原文]

### 提出时机
[在哪个阶段/步骤提出]

### LLM 建议
[如有]

---

返工到其他阶段

返工到 flow-design、impl、verify 阶段时使用。

流程

1. 记录问题：

   aide flow issue "准备返工前处理需求整合: [原因简述]"
   

2. 创建/更新 new-requirements.md（见下方格式）

3. 更新细则文档：

   • 在导览部分添加返工声明
   • 梳理：已完成项、未完成项、需重新处理项
   • 处理需求冲突
   • 融入新需求
   • 删除返工声明

4. 向用户发出提醒（见下方模板）

5. 执行返工命令：

   aide flow back-part [阶段] "[原因]"
   

6. 执行确认命令：

   aide flow back-confirm --key [key]
   

new-requirements.md 格式

位置：.aide/new-requirements.md

# 新需求记录

## 返工 [时间戳]

### 用户反馈
[原文]

### 提出时机
[阶段/步骤]

### 影响分析
- 已完成项：[列表]
- 未完成项：[列表]
- 需重新处理：[列表]

### 冲突处理
[如何处理与原细则的冲突]

---

提醒用户模板

返工到 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. 确认成功后，系统会自动执行返工操作并创建清洁提交

命令说明

# 首次调用：生成 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