跳到主要内容

计划模式 (Plan Mode)

什么是计划模式？​

计划模式是 Claude Code 处理复杂、多步骤任务的智能工作流。当面临大型重构、新功能开发或系统性改动时，Claude 会先制定详细计划，然后逐步执行。

这就像建筑师先画蓝图，再开始施工。

为什么需要计划模式？​

传统问题​

没有计划的复杂任务往往导致：

  • 🔄 方向混乱：中途发现设计缺陷需要返工
  • 🧩 遗漏细节：忘记处理依赖关系和边缘情况
  • ⏰ 时间浪费：反复修改和调整方案
  • 🐛 引入错误：匆忙实施导致 bug 和不一致

计划模式的优势​

  • 🎯 整体视角：在动手前考虑全局架构
  • 📋 步骤清晰：将复杂任务分解为可执行的小步骤
  • ✅ 可跟踪进度：每个步骤都有明确的完成标准
  • 🔄 可调整方案：在执行前讨论和优化计划

计划模式的工作流程​

1. 触发计划模式​

自动触发​

Claude 会在以下情况自动进入计划模式：

> 重构整个用户认证系统，支持多种登录方式并提升安全性
# 复杂度：高 → 自动进入计划模式

> 为应用添加国际化支持，包括前端、后端和数据库
# 影响范围：大 → 自动进入计划模式

手动触发​

你也可以手动启用计划模式：

> /plan 实现实时聊天功能
> /plan 优化应用性能，目标是首屏加载时间减半

2. 计划制定阶段​

Claude 会分析任务并生成结构化计划：

## 📋 任务：实现用户认证系统重构

### 🎯 目标
- 支持邮箱/用户名登录
- 集成第三方 OAuth (Google, GitHub)
- 实现 JWT + Refresh Token 机制
- 添加双因子认证 (2FA)
- 提升安全性和用户体验

### 🔍 影响分析
- **前端**：登录组件、认证状态管理、路由守卫
- **后端**：认证 API、中间件、数据库模型
- **安全**：密码策略、会话管理、攻击防护

### 📝 执行计划

#### 阶段 1：准备工作 (预计 30 分钟)
- [ ] 备份现有认证代码
- [ ] 分析当前用户数据结构
- [ ] 设计新的数据库 schema
- [ ] 准备迁移脚本

#### 阶段 2：后端重构 (预计 2 小时)
- [ ] 更新用户模型和数据库表
- [ ] 实现新的认证服务
- [ ] 创建 JWT 工具类
- [ ] 实现 OAuth 集成
- [ ] 添加 2FA 支持

#### 阶段 3：前端适配 (预计 1.5 小时)
- [ ] 重构登录组件
- [ ] 更新认证状态管理
- [ ] 实现 OAuth 登录界面
- [ ] 添加 2FA 设置页面

#### 阶段 4：测试和验证 (预计 1 小时)
- [ ] 编写单元测试
- [ ] 执行集成测试
- [ ] 安全性检查
- [ ] 用户体验测试

### ⚠️ 风险点
- 数据迁移可能影响现有用户
- OAuth 配置需要外部服务支持
- 2FA 实施需要额外的依赖包

### 🎯 成功标准
- [ ] 所有测试通过
- [ ] 现有用户数据完整迁移
- [ ] 新认证功能正常工作
- [ ] 性能没有明显下降

3. 计划确认阶段​

Claude 会向你展示计划并请求确认：

Claude: 我已经制定了认证系统重构的详细计划。请查看上述计划。

你想要：
1. 🚀 开始执行这个计划
2. ✏️ 修改计划的某些部分  
3. 📋 查看更多实施细节
4. ⏸️ 暂停，稍后再执行

你的选择是什么？

4. 执行阶段​

一旦确认计划，Claude 开始逐步执行：

[✅ 阶段 1.1 完成] 备份现有认证代码到 backup/auth-legacy/
[🔄 阶段 1.2 进行中] 分析当前用户数据结构...

发现：
- User 表包含 email, username, password_hash
- 缺少 OAuth 相关字段
- 没有 2FA 配置字段

[✅ 阶段 1.2 完成] 数据结构分析完成
[🔄 阶段 1.3 进行中] 设计新的数据库 schema...

计划模式的类型​

1. 线性计划 (Sequential Plan)​

步骤必须按顺序执行：

1. 设计数据库 schema
2. 实现后端 API  
3. 开发前端界面
4. 集成测试

适用于：架构变更、数据迁移、部署流程

2. 并行计划 (Parallel Plan)​

某些步骤可以同时进行：

并行组 A：
- 实现用户认证 API
- 设计登录界面

并行组 B：  
- 编写单元测试
- 准备文档更新

汇合点：集成测试

适用于：功能开发、性能优化、多模块项目

3. 迭代计划 (Iterative Plan)​

分多个迭代周期完成：

迭代 1：基础认证 (MVP)
- 邮箱/密码登录
- 基本会话管理

迭代 2：增强功能
- OAuth 第三方登录
- 密码重置功能

迭代 3：安全增强
- 双因子认证
- 登录异常检测

适用于：大型项目、渐进式改进、MVP 开发

最佳实践​

1. 计划的颗粒度​

✅ 合适的颗粒度​

- [ ] 实现用户注册 API 端点
- [ ] 添加邮箱验证逻辑  
- [ ] 创建注册表单组件
- [ ] 集成表单验证

❌ 过于粗糙​

- [ ] 完成用户系统
- [ ] 做前端界面

❌ 过于细碎​

- [ ] 创建 register.js 文件
- [ ] 添加第一行代码
- [ ] 导入 express 模块
- [ ] 写一个变量声明

2. 风险管理​

在计划中识别和标记风险：

### ⚠️ 高风险步骤
- **数据库迁移** (风险：数据丢失)
  - 缓解：先在测试环境验证
  - 备案：准备回滚脚本

- **第三方服务集成** (风险：服务不可用)
  - 缓解：实现优雅降级
  - 备案：提供手动登录选项

3. 检查点设置​

在关键节点设置验证：

#### 检查点 1：数据迁移完成
验证条件：
- [ ] 所有用户数据成功迁移
- [ ] 新旧密码哈希都能验证
- [ ] 测试用户可以正常登录

#### 检查点 2：API 功能验证
验证条件：
- [ ] 所有认证端点响应正常
- [ ] 错误处理覆盖各种情况
- [ ] API 文档更新完成

4. 进度跟踪​

实时更新计划进度：

> 当前进度如何？

Claude: 
📊 整体进度：60% (12/20 步骤完成)

✅ 已完成：
- 数据库 schema 设计
- 后端 API 实现
- JWT 工具类开发

🔄 进行中：
- 前端登录组件开发 (70%)

⏳ 待完成：
- OAuth 集成
- 测试和文档

高级技巧​

1. 条件分支计划​

### 分支决策点：现有用户数据处理

**选项 A**：在线迁移
- 优势：用户无感知
- 风险：可能影响性能
- 条件：用户数量 < 10万

**选项 B**：离线迁移  
- 优势：安全可靠
- 风险：需要维护窗口
- 条件：用户数量 > 10万

**决策依据**：当前用户数量和业务要求

2. 回滚计划​

### 🔄 回滚策略

如果在执行过程中遇到重大问题：

**立即回滚触发条件**：
- 数据丢失或损坏
- 系统崩溃或不可用
- 安全漏洞发现

**回滚步骤**：
1. 停止新部署
2. 恢复数据库备份
3. 回滚代码到上一版本
4. 通知相关团队

3. 质量门槛​

### ✅ 质量标准

每个阶段完成需满足：

**代码质量**：
- ESLint 0 errors, 0 warnings
- TypeScript 严格模式通过
- 测试覆盖率 > 80%

**功能质量**：
- 所有用户场景测试通过
- 性能指标达标
- 安全扫描无高危问题

常见场景应用​

场景 1：性能优化项目​

> /plan 优化应用性能，首屏加载时间从5秒降到2秒以内

Claude 会制定包含：

  • 性能问题诊断
  • 优化方案设计
  • 代码分割实施
  • 缓存策略优化
  • 图片和资源优化
  • 验证和监控的全面计划

场景 2：技术栈迁移​

> /plan 将项目从 React Class 组件迁移到 Function 组件 + Hooks

计划包含：

  • 迁移策略制定
  • 组件优先级排序
  • 渐进式迁移实施
  • 测试验证流程
  • 团队培训安排

场景 3：新功能开发​

> /plan 为电商网站添加完整的购物车和结账功能

涵盖：

  • 需求分析和技术设计
  • 数据模型设计
  • API 开发
  • 前端界面实现
  • 支付集成
  • 测试和部署

掌握计划模式后，你可以学习 自动计划模式，了解如何让 Claude 更智能地判断何时使用计划模式。