# 工作流技巧

本文介绍如何将 Claude Code 融入日常开发工作流，从个人效率到团队协作，建立高效的 AI 辅助开发流程。

## 规划-执行工作流

最有效的 Claude Code 使用模式是**先规划后执行**，避免直接让 AI 写代码。

### 基本流程

```
1. 需求分析 → 2. 制定计划 → 3. 确认计划 → 4. 分步执行 → 5. 验证结果
```

### 实践步骤

**第一步：让 Claude 理解需求**

```
> 阅读 @src/services/ 目录下的代码，理解现有架构。
> 不要写任何代码，只分析。
```

**第二步：制定实施计划**

```
> 基于你对现有代码的理解，为"用户权限管理功能"制定详细的实施计划。
> 包括：文件变更、新增文件、依赖关系、风险点。
```

**第三步：确认并调整计划**

审查 Claude 的计划，提出修改意见：

```
> 计划中的第3步，我希望使用 Redis 缓存而不是内存缓存。请调整计划。
```

**第四步：分步执行**

```
> 现在执行计划的第1步：创建权限模型。
```

每完成一步，验证结果后再继续下一步。

## 功能分支工作流

### Git 分支最佳实践

```bash
# 1. 创建功能分支
git checkout -b feature/user-permissions

# 2. 进入项目目录启动 Claude Code
cd your-project && claude

# 3. 开发过程中多次提交
> /commit  # 第一次提交
# 继续开发...
> /commit  # 第二次提交

# 4. 功能完成，创建 PR
> 为当前分支创建 PR 描述，总结所有提交的变更
```

### 提交频率建议

- **小步提交**：每完成一个独立功能点就提交

- **提交信息**：使用 `/commit` 自动生成规范信息

- **避免大提交**：不要积累太多变更再一次提交

## 代码审查工作流

### 自我审查

在提交 PR 前，先让 Claude 审查：

```
> /review
> 重点检查：安全性、性能、代码风格
```

### 审查他人代码

```bash
# 获取 PR 变更
gh pr diff 123 | claude "审查这个 PR，关注：
1. 逻辑正确性
2. 边界情况处理
3. 错误处理
4. 代码可维护性"
```

### 多阶段审查流程

对于复杂 PR，使用结构化审查：

```
> 第一阶段：检查架构设计是否合理
> 第二阶段：检查实现是否符合设计
> 第三阶段：检查测试覆盖是否充分
> 第四阶段：检查文档是否完整
```

## 测试驱动工作流

### TDD 与 Claude Code

```
1. 写测试 → 2. 运行测试（失败）→ 3. 写代码 → 4. 运行测试（通过）→ 5. 重构
```

### 实践步骤

**第一步：定义测试**

```
> 为用户注册功能编写测试用例，覆盖：
> - 正常注册
> - 邮箱格式错误
> - 密码太弱
> - 用户已存在
> 先写测试，不要实现功能。
```

**第二步：验证测试失败**

```bash
npm test  # 预期：测试失败
```

**第三步：实现功能**

```
> 现在实现代码，让所有测试通过。
```

**第四步：验证并重构**

```bash
npm test  # 预期：测试通过
```

```
> 测试通过了。现在重构代码，提高可读性，但不要破坏测试。
```

## 调试工作流

### 结构化调试

```
1. 复现问题 → 2. 收集信息 → 3. 分析原因 → 4. 验证假设 → 5. 修复问题
```

### 实践步骤

**第一步：描述问题**

```
> 问题描述：用户登录后，点击"我的订单"显示空白页
> 预期行为：显示用户的订单列表
> 复现步骤：登录 → 点击"我的订单"
```

**第二步：收集信息**

```
> 分析以下文件，找出可能的问题：
> @src/pages/MyOrders.tsx
> @src/services/OrderService.ts
> @src/api/orders.ts
```

**第三步：分析日志**

```bash
# 收集错误日志
cat app.log | claude "分析这些日志，找出与订单页面相关的错误"
```

**第四步：修复并验证**

```
> 基于分析，修复 OrderService 中的问题
> 修复后，我会测试验证
```

## 子代理协作工作流

### 并行处理

利用子代理并行处理多个任务：

```
> 同时执行以下任务：
> 1. 使用 Explore 代理分析项目结构
> 2. 使用 Plan 代理设计新功能方案
```

### 专业分工

不同子代理有不同专长：

| 代理 | 专长 | 使用场景 |
|------|------|----------|
| Explore | 快速搜索 | 查找代码、理解结构 |
| Plan | 架构设计 | 复杂功能规划 |
| 后台代理 | 并行处理 | 批量任务、长时间任务 |

## IDE 集成工作流

### VS Code 集成

1. 安装 Claude Code VS Code 扩展

2. 使用 `Cmd+Esc` / `Ctrl+Esc` 快速切换

3. 在编辑器中选中代码后呼叫 Claude

### 终端 + IDE 协作

```
终端 (Claude Code)          IDE (VS Code)
     ↓                          ↓
  分析、规划               手动调整、阅读
     ↓                          ↓
  生成代码  ←──────────→   查看差异、测试
     ↓                          ↓
  提交代码                   继续开发
```

## 团队协作工作流

### CLAUDE.md 规范化

团队共享 CLAUDE.md 配置：

```markdown
# 团队开发规范

## 代码风格
- ESLint 配置：.eslintrc.js
- Prettier 配置：.prettierrc

## Git 规范
- 分支命名：feature/xxx, fix/xxx, hotfix/xxx
- Commit 格式：type(scope): description

## 测试要求
- 单元测试覆盖率 > 80%
- E2E 测试覆盖核心流程
```

### PR 模板

让 Claude 使用统一的 PR 模板：

```
> 使用以下模板创建 PR 描述：
> ## 变更内容
> ## 测试计划
> ## 截图（如有 UI 变更）
> ## Checklist
```

## 工作流检查清单

### 开始新任务前

- [ ] 创建功能分支

- [ ] 使用 `/clear` 清空上下文

- [ ] 让 Claude 先理解现有代码

- [ ] 制定实施计划

### 开发过程中

- [ ] 分步执行，每步验证

- [ ] 小步提交，频繁 `/commit`

- [ ] 监控上下文使用 `/context`

- [ ] 需要时使用 `/compact`

### 提交前

- [ ] 运行 `/review` 自我审查

- [ ] 运行所有测试

- [ ] 检查 lint 错误

- [ ] 生成 PR 描述

## 下一步

- 学习 [CLI 技巧](/docs/usage/cli-tips) 掌握更多命令

- 了解 [自定义命令](/docs/usage/cli-tips) 创建团队专属命令

- 探索 [最佳实践](/docs/usage/best-practices) 深入优化工作流