高级工作流模式
本节介绍使用Claude Code的最佳工作流模式，帮助你更高效地完成复杂任务。
核心原则
上下文管理
Claude Code的上下文窗口是有限的资源。高效的工作流需要主动管理上下文：
❌ 错误做法：一个会话做所有事
- 上下文溢出
- 早期信息被遗忘
- 响应变慢
✅ 正确做法：分阶段处理
- 一个阶段一个会话
- 定期清除上下文
- 使用子Agent处理子任务黄金法则：60%上下文阈值
当上下文使用超过60%时：
1. 使用 /compact 压缩
2. 或使用 /clear 开始新会话
3. 保留关键信息到CLAUDE.md四阶段工作流
Phase 1: 研究（Research）
目标：理解问题，不写代码
提示词：
"分析这个问题，不要写代码。告诉我：
1. 当前状态是什么
2. 需要改动哪些文件
3. 有什么风险"
完成后：/clearPhase 2: 规划（Plan）
目标：制定详细计划
提示词：
"根据分析结果，制定详细的实施计划：
1. 步骤一：...
2. 步骤二：...
3. 步骤三：...
每个步骤说明输入输出和依赖关系"
完成后：保存计划，/clearPhase 3: 执行（Implement）
目标：按计划执行
提示词：
"按照计划执行步骤一，完成后告诉我结果"
执行每个步骤时，确保：
- 只关注当前步骤
- 验证每步结果
- 记录问题
完成后：/clearPhase 4: 验证（Validate）
目标：验证实现正确性
提示词：
"验证实现是否正确：
1. 运行测试
2. 检查边界情况
3. 确认功能完整"
完成！"先规划后执行"模式
标准流程
你：添加用户登录功能
Claude：我来规划这个任务...
实施计划：
1. 创建登录表单组件
2. 实现认证逻辑
3. 添加token管理
4. 配置路由保护
请确认计划是否正确，我再开始编码。
你：确认，开始执行
Claude：开始执行...强制规划
markdown
<!-- .claude/commands/implement.md -->
# 实施功能
## 规划阶段
在开始编码前，先提供详细的实施计划：
1. 需要创建/修改哪些文件
2. 每个文件的具体改动
3. 依赖关系
4. 潜在风险
**不要立即编写代码**，等待用户确认。
功能需求：$ARGUMENTSGit协作最佳实践
分支策略
1. 为每个任务创建新分支
2. 完成后创建PR
3. 合并后删除分支
你：实现用户头像上传
Claude：创建分支 feature/avatar-upload
实现功能
运行测试
创建PR #123Git Worktree并行开发
当需要同时处理多个任务时：
bash
# 创建worktree
git worktree add ../project-feature-a feature-a
git worktree add ../project-feature-b feature-b
# 在不同目录运行Claude
cd ../project-feature-a && claude
cd ../project-feature-b && claude安全的Git工作流
markdown
<!-- .claude/commands/feature.md -->
# 功能开发流程
## 分支管理
1. 从main创建feature分支
2. 定期rebase main
3. 完成后创建PR
## 禁止操作
- 不要force push到main
- 不要直接commit到main
- 不要跳过PR流程
功能：$ARGUMENTS上下文管理技巧
何时清除上下文
触发条件：
- 切换到完全不同的任务
- 上下文超过60%
- 发现Claude"忘记"了早期信息
方法：
/clear # 完全清除
/compact # 压缩保留关键信息保存关键信息
在清除上下文前：
你：总结刚才的工作，保存到CLAUDE.md
Claude：已完成用户认证模块，关键信息：
- 使用JWT认证
- token有效期7天
- 刷新token逻辑在auth.ts
已更新CLAUDE.md使用子Agent
将子任务委托给子Agent：
你：实现支付功能，用子Agent处理安全审查
Claude：主任务：实现支付功能
子Agent：安全审查
[主对话实现功能]
[子Agent安全审查]
安全审查结果：发现2个潜在问题...
[修复问题]任务分解策略
大任务分解
❌ 大任务：重构整个用户模块
✅ 分解后：
1. 分析当前用户模块结构
2. 设计新的模块架构
3. 创建新的服务层
4. 迁移认证逻辑
5. 迁移用户CRUD
6. 更新API层
7. 运行测试
8. 清理旧代码每个子任务一个会话
会话1：分析当前结构 → /clear
会话2：设计新架构 → /clear
会话3：创建服务层 → /clear
...调试工作流
问题定位
步骤1：描述问题
"用户登录后偶尔被登出，帮我定位原因"
步骤2：Claude分析
Claude分析可能的原因...
步骤3：提供线索
"这是auth.ts的token逻辑..."
步骤4：确认修复
"修复后请解释原因"日志分析
你：分析这些错误日志
[粘贴日志]
Claude：分析中...
问题：Redis连接超时
原因：连接池配置不当
建议：增加连接池大小...代码审查工作流
审查清单
markdown
<!-- .claude/commands/review.md -->
# 代码审查
## 审查要点
### 安全性
- [ ] 输入验证
- [ ] 认证授权
- [ ] 数据加密
- [ ] 注入防护
### 性能
- [ ] 算法复杂度
- [ ] 数据库查询
- [ ] 缓存使用
### 可维护性
- [ ] 代码结构
- [ ] 命名规范
- [ ] 注释完整性
### 测试
- [ ] 单元测试
- [ ] 边界情况
- [ ] 错误处理
审查目标：$ARGUMENTS迭代改进
会话1：初步审查，列出问题
会话2：修复问题A
会话3：修复问题B
会话4：验证修复团队协作
共享配置
.claude/
├── commands/ # 共享命令
├── agents/ # 共享Agent
└── settings.json # 共享设置
提交到Git，团队成员自动获得代码规范统一
markdown
<!-- CLAUDE.md -->
## 团队编码规范
### 命名约定
- 变量：camelCase
- 常量：UPPER_SNAKE_CASE
- 组件：PascalCase
- 文件：kebab-case
### 代码风格
- 使用ESLint配置
- 使用Prettier格式化
- 使用TypeScript严格模式
### Git规范
- Conventional Commits
- PR模板
- Review要求最佳实践总结
| 实践 | 说明 |
|---|---|
| 四阶段工作流 | 研究→规划→执行→验证 |
| 60%上下文阈值 | 超过时压缩或清除 |
| 先规划后执行 | 让Claude先制定计划 |
| 任务分解 | 大任务拆成小任务 |
| 子Agent委托 | 子任务用子Agent处理 |
| Git分支隔离 | 每个任务新分支 |
下一步
学会了工作流模式后，继续学习 故障排除指南。