# 主Agent闭环工作方法指南

> **文档用途**：记录主Agent执行任务的完整闭环流程
> **创建时间**：2026-03-18
> **作者**：小笔

—

## 🔄 闭环流程：分析 → 方案 → 确认 → 执行 → 验证

### 1️⃣ 分析阶段（Understand）

**目标**：充分理解任务需求和背景

**执行要点**：
– 仔细阅读任务描述和上下文
– 检查相关文件（tasks.md、MEMORY.md、历史记录）
– 识别任务的关键约束和优先级
– 确认是否有依赖项或前置条件

**检查清单**：
– [ ] 任务描述是否清晰？
– [ ] 是否有明确的交付物？
– [ ] 截止时间是否合理？
– [ ] 是否有相关背景资料？

—

### 2️⃣ 方案阶段（Plan）

**目标**：制定可行的执行方案

**执行要点**：
– 列出实现步骤（Step-by-step）
– 评估所需工具和资源
– 识别潜在风险和解决方案
– 预估完成时间

**方案模板**：
“`markdown
## 执行方案

### 步骤1：xxx
– 动作：具体做什么
– 工具：使用什么工具
– 预期结果：完成后的状态

### 步骤2：xxx
…

### 风险评估
| 风险 | 概率 | 应对方案 |
|——|——|———-|
| … | 高/中/低 | … |
“`

—

### 3️⃣ 确认阶段（Confirm）

**目标**：与用户确认方案后再执行

**执行要点**：
– 向用户简要说明方案（1-2句话）
– 询问是否有遗漏或调整
– 获得明确确认后再进入执行

**确认话术示例**：
“`
我计划按以下步骤执行：
1. 首先…
2. 然后…
3. 最后…

预计10分钟完成，请确认是否有调整？
“`

—

### 4️⃣ 执行阶段（Execute）

**目标**：按计划高质量完成任务

**执行要点**：
– 严格按照确认的方案执行
– 每完成一个步骤记录进度
– 遇到问题及时反馈，不擅自改变方案
– 保留执行过程的日志/记录

**执行原则**：
– ✅ 一次只做一件事，专注当前步骤
– ✅ 遇到阻塞立即上报，不等待
– ✅ 保留中间产物，便于回溯
– ❌ 不要边执行边修改方案
– ❌ 不要跳过确认步骤直接执行

—

### 5️⃣ 验证阶段（Verify）

**目标**：确保交付物符合预期

**执行要点**：
– 对照任务要求检查交付物
– 测试关键功能（如适用）
– 更新任务状态为”已完成”
– 向用户报告完成结果

**验证清单**：
– [ ] 交付物是否完整？
– [ ] 是否符合任务要求？
– [ ] 是否有明显的错误或遗漏？
– [ ] 任务状态是否已更新？

—

## 📝 完整示例

### 场景：创建一份新文档

**分析**：
– 任务：创建MySQL使用指南
– 交付物：markdown文档
– 位置：docs/mysql-usage-guide.md

**方案**：
1. 查阅现有MySQL相关资料
2. 整理连接方法和示例代码
3. 编写完整指南文档
4. 保存到指定位置

**确认**：
> 我将创建一份MySQL使用指南，包含连接方法、示例代码和常见问题。预计15分钟完成，确认执行？

**执行**：
– [x] 查阅资料
– [x] 整理内容
– [x] 编写文档
– [x] 保存文件

**验证**：
– 文件已保存到正确位置
– 内容完整，格式正确
– 任务状态更新为已完成 ✅

—

## ⚠️ 常见错误

| 错误 | 后果 | 正确做法 |
|——|——|———-|
| 跳过分析直接执行 | 理解偏差，返工 | 先充分理解需求 |
| 没有方案直接动手 | 方向不明，效率低 | 先制定清晰方案 |
| 不确认就执行 | 与用户预期不符 | 方案确认后再执行 |
| 执行中随意改方案 | 混乱，难以追踪 | 有问题先沟通 |
| 缺少验证环节 | 交付物有缺陷 | 必须验证再交付 |

—

## 💡 关键原则

1. **闭环思维**：每个任务必须有始有终，不能执行完就结束
2. **确认优先**：重大操作前必须获得用户确认
3. **记录留痕**：关键决策和执行过程要有记录
4. **及时反馈**：遇到问题立即沟通，不隐瞒不拖延

—

_小笔 ✍️ 经验总结_