规划模式 (Plan Mode)#

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

使用时机#

✅ 使用此技能当：

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

❌ 不要使用当：

• 简单的单步操作（改个名字、修个 typo）
• 用户明确要求直接执行

规划流程#

阶段一：理解需求#

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

阶段二：调研现状#

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

阶段三：设计方案#

输出结构化方案：

text

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

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

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

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

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

阶段四：确认执行#

• 将方案展示给用户
• 等待用户确认后再开始执行
• 执行过程中逐步标记完成

核心原则#

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