工作流技巧
高效的 Claude Code 开发工作流程,提升团队协作效率
工作流技巧¶
本文介绍如何将 Claude Code 融入日常开发工作流,从个人效率到团队协作,建立高效的 AI 辅助开发流程。
规划-执行工作流¶
最有效的 Claude Code 使用模式是先规划后执行,避免直接让 AI 写代码。
基本流程¶
1. 需求分析 → 2. 制定计划 → 3. 确认计划 → 4. 分步执行 → 5. 验证结果
实践步骤¶
第一步:让 Claude 理解需求
> 阅读 @src/services/ 目录下的代码,理解现有架构。
> 不要写任何代码,只分析。
第二步:制定实施计划
> 基于你对现有代码的理解,为"用户权限管理功能"制定详细的实施计划。
> 包括:文件变更、新增文件、依赖关系、风险点。
第三步:确认并调整计划
审查 Claude 的计划,提出修改意见:
> 计划中的第3步,我希望使用 Redis 缓存而不是内存缓存。请调整计划。
第四步:分步执行
> 现在执行计划的第1步:创建权限模型。
每完成一步,验证结果后再继续下一步。
功能分支工作流¶
Git 分支最佳实践¶
# 1. 创建功能分支
git checkout -b feature/user-permissions
# 2. 进入项目目录启动 Claude Code
cd your-project && claude
# 3. 开发过程中多次提交
> /commit # 第一次提交
# 继续开发...
> /commit # 第二次提交
# 4. 功能完成,创建 PR
> 为当前分支创建 PR 描述,总结所有提交的变更
提交频率建议¶
-
小步提交:每完成一个独立功能点就提交
-
提交信息:使用
/commit自动生成规范信息 -
避免大提交:不要积累太多变更再一次提交
代码审查工作流¶
自我审查¶
在提交 PR 前,先让 Claude 审查:
> /review
> 重点检查:安全性、性能、代码风格
审查他人代码¶
# 获取 PR 变更
gh pr diff 123 | claude "审查这个 PR,关注:
1. 逻辑正确性
2. 边界情况处理
3. 错误处理
4. 代码可维护性"
多阶段审查流程¶
对于复杂 PR,使用结构化审查:
> 第一阶段:检查架构设计是否合理
> 第二阶段:检查实现是否符合设计
> 第三阶段:检查测试覆盖是否充分
> 第四阶段:检查文档是否完整
测试驱动工作流¶
TDD 与 Claude Code¶
1. 写测试 → 2. 运行测试(失败)→ 3. 写代码 → 4. 运行测试(通过)→ 5. 重构
实践步骤¶
第一步:定义测试
> 为用户注册功能编写测试用例,覆盖:
> - 正常注册
> - 邮箱格式错误
> - 密码太弱
> - 用户已存在
> 先写测试,不要实现功能。
第二步:验证测试失败
npm test # 预期:测试失败
第三步:实现功能
> 现在实现代码,让所有测试通过。
第四步:验证并重构
npm test # 预期:测试通过
> 测试通过了。现在重构代码,提高可读性,但不要破坏测试。
调试工作流¶
结构化调试¶
1. 复现问题 → 2. 收集信息 → 3. 分析原因 → 4. 验证假设 → 5. 修复问题
实践步骤¶
第一步:描述问题
> 问题描述:用户登录后,点击"我的订单"显示空白页
> 预期行为:显示用户的订单列表
> 复现步骤:登录 → 点击"我的订单"
第二步:收集信息
> 分析以下文件,找出可能的问题:
> @src/pages/MyOrders.tsx
> @src/services/OrderService.ts
> @src/api/orders.ts
第三步:分析日志
# 收集错误日志
cat app.log | claude "分析这些日志,找出与订单页面相关的错误"
第四步:修复并验证
> 基于分析,修复 OrderService 中的问题
> 修复后,我会测试验证
子代理协作工作流¶
并行处理¶
利用子代理并行处理多个任务:
> 同时执行以下任务:
> 1. 使用 Explore 代理分析项目结构
> 2. 使用 Plan 代理设计新功能方案
专业分工¶
不同子代理有不同专长:
| 代理 | 专长 | 使用场景 |
|---|---|---|
| Explore | 快速搜索 | 查找代码、理解结构 |
| Plan | 架构设计 | 复杂功能规划 |
| 后台代理 | 并行处理 | 批量任务、长时间任务 |
IDE 集成工作流¶
VS Code 集成¶
-
安装 Claude Code VS Code 扩展
-
使用
Cmd+Esc/Ctrl+Esc快速切换 -
在编辑器中选中代码后呼叫 Claude
终端 + IDE 协作¶
终端 (Claude Code) IDE (VS Code)
↓ ↓
分析、规划 手动调整、阅读
↓ ↓
生成代码 ←──────────→ 查看差异、测试
↓ ↓
提交代码 继续开发
团队协作工作流¶
CLAUDE.md 规范化¶
团队共享 CLAUDE.md 配置:
# 团队开发规范
## 代码风格
- 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 描述