---
name: plan-mode
description: "结构化规划模式 — 在执行复杂任务前先做系统性规划。借鉴 Claude Code 的 Plan Agent。"
homepage: https://github.com/jobzhao15/openclaw-enhance
metadata: { "openclaw": { "emoji": "📋", "requires": { "bins": [] } } }
---

# 规划模式 (Plan Mode)

在执行复杂或多步骤任务前，进入结构化规划模式。

## 使用时机

✅ **使用此技能当：**
- 用户请求涉及多个步骤的复杂任务
- "帮我规划一下..."、"设计一个方案..."
- 需要在动手前理清思路
- 修改涉及多个文件或系统

❌ **不要使用当：**
- 简单的单步操作（改个名字、修个 typo）
- 用户明确要求直接执行

## 规划流程

### 阶段一：理解需求
1. **复述需求** — 用自己的话总结用户要做什么
2. **识别约束** — 有什么限制条件？时间、兼容性、依赖？
3. **提出澄清问题** — 如果有不确定的地方，先问清楚再规划

### 阶段二：调研现状
1. **读相关代码** — 理解现有实现，不要凭空设计
2. **找可复用的** — 搜索已有的函数、工具、模式
3. **识别风险** — 哪些地方可能出问题？

### 阶段三：设计方案
输出结构化方案：

```
## 背景
为什么要做这个改动？解决什么问题？

## 方案
### 步骤 1: [描述]
- 修改文件: path/to/file
- 具体操作: ...
- 复用已有: function_name from file

### 步骤 2: [描述]
...

## 风险与回退
- 风险1: ...  → 缓解措施: ...

## 验证方式
- [ ] 怎么确认改动正确？
- [ ] 运行什么测试？
```

### 阶段四：确认执行
- 将方案展示给用户
- 等待用户确认后再开始执行
- 执行过程中逐步标记完成

## 核心原则
- **先理解，再设计，最后执行** — 不要一上来就写代码
- **方案要具体** — 具体到哪个文件哪个函数，不要泛泛而谈
- **复用优先** — 能用已有的就不要重新造
- **最小变更** — 只改需要改的，不顺手重构