# 主Agent闭环工作方法指南\n\n> **文档用途**：记录主Agent执行任务的完整闭环流程 \n> **创建时间**：2026-03-18 \n> **作者**：小笔\n\n—\n\n## 🔄 闭环流程：分析 → 方案 → 确认 → 执行 → 验证\n\n### 1️⃣ 分析阶段（Understand）\n\n**目标**：充分理解任务需求和背景\n\n**执行要点**：\n- 仔细阅读任务描述和上下文\n- 检查相关文件（tasks.md、MEMORY.md、历史记录）\n- 识别任务的关键约束和优先级\n- 确认是否有依赖项或前置条件\n\n**检查清单**：\n- [ ] 任务描述是否清晰？\n- [ ] 是否有明确的交付物？\n- [ ] 截止时间是否合理？\n- [ ] 是否有相关背景资料？\n\n—\n\n### 2️⃣ 方案阶段（Plan）\n\n**目标**：制定可行的执行方案\n\n**执行要点**：\n- 列出实现步骤（Step-by-step）\n- 评估所需工具和资源\n- 识别潜在风险和解决方案\n- 预估完成时间\n\n**方案模板**：\n\n\n—\n\n### 3️⃣ 确认阶段（Confirm）\n\n**目标**：与用户确认方案后再执行\n\n**执行要点**：\n- 向用户简要说明方案（1-2句话）\n- 询问是否有遗漏或调整\n- 获得明确确认后再进入执行\n\n**确认话术示例**：\n\n\n—\n\n### 4️⃣ 执行阶段（Execute）\n\n**目标**：按计划高质量完成任务\n\n**执行要点**：\n- 严格按照确认的方案执行\n- 每完成一个步骤记录进度\n- 遇到问题及时反馈，不擅自改变方案\n- 保留执行过程的日志/记录\n\n**执行原则**：\n- ✅ 一次只做一件事，专注当前步骤\n- ✅ 遇到阻塞立即上报，不等待\n- ✅ 保留中间产物，便于回溯\n- ❌ 不要边执行边修改方案\n- ❌ 不要跳过确认步骤直接执行\n\n—\n\n### 5️⃣ 验证阶段（Verify）\n\n**目标**：确保交付物符合预期\n\n**执行要点**：\n- 对照任务要求检查交付物\n- 测试关键功能（如适用）\n- 更新任务状态为”已完成”\n- 向用户报告完成结果\n\n**验证清单**：\n- [ ] 交付物是否完整？\n- [ ] 是否符合任务要求？\n- [ ] 是否有明显的错误或遗漏？\n- [ ] 任务状态是否已更新？\n\n—\n\n## 📝 完整示例\n\n### 场景：创建一份新文档\n\n**分析**：\n- 任务：创建MySQL使用指南\n- 交付物：markdown文档\n- 位置：docs/mysql-usage-guide.md\n\n**方案**：\n1. 查阅现有MySQL相关资料\n2. 整理连接方法和示例代码\n3. 编写完整指南文档\n4. 保存到指定位置\n\n**确认**：\n> 我将创建一份MySQL使用指南，包含连接方法、示例代码和常见问题。预计15分钟完成，确认执行？\n\n**执行**：\n- [x] 查阅资料\n- [x] 整理内容\n- [x] 编写文档\n- [x] 保存文件\n\n**验证**：\n- 文件已保存到正确位置\n- 内容完整，格式正确\n- 任务状态更新为已完成 ✅\n\n—\n\n## ⚠️ 常见错误\n\n| 错误 | 后果 | 正确做法 |\n|——|——|———-|\n| 跳过分析直接执行 | 理解偏差，返工 | 先充分理解需求 |\n| 没有方案直接动手 | 方向不明，效率低 | 先制定清晰方案 |\n| 不确认就执行 | 与用户预期不符 | 方案确认后再执行 |\n| 执行中随意改方案 | 混乱，难以追踪 | 有问题先沟通 |\n| 缺少验证环节 | 交付物有缺陷 | 必须验证再交付 |\n\n—\n\n## 💡 关键原则\n\n1. **闭环思维**：每个任务必须有始有终，不能执行完就结束\n2. **确认优先**：重大操作前必须获得用户确认\n3. **记录留痕**：关键决策和执行过程要有记录\n4. **及时反馈**：遇到问题立即沟通，不隐瞒不拖延\n\n—\n\n_小笔 ✍️ 经验总结_\n