实战工作流
本章展示在实际项目开发中，Claude Code 如何介入各个阶段的工作流。
5.1 新功能开发流程
这是最常见的场景：从零开始开发一个新功能。
工作流概览
需求理解 → 方案设计 → 分步实现 → 测试验证 → 代码审查 → 提交
│ │ │ │ │ │
│ Brainstorming Plan Mode 逐个文件 Claude /commit
│ Skill 出计划 编辑执行 运行测试 智能提交实战演示
需求：为用户管理页面添加搜索和筛选功能。
Step 1：需求分析
我想给用户管理页面添加搜索（按用户名/邮箱）和筛选（按角色/状态）功能，
帮我分析一下应该怎么做。Claude Code 会自动激活 brainstorming skill，引导你理清需求。
Step 2：方案设计
进入 Plan Mode，设计实现方案。Claude 会：
- 读取现有的用户管理页面代码
- 分析现有的 API 层和组件结构
- 提出 2-3 种实现方案
- 推荐最优方案并给出理由
Step 3：分步实现
按计划开始实现。Claude 会按计划逐步实现：先改 API → 再改组件 → 最后加测试。每一步你都审查变更。
Step 4：验证
帮我运行相关测试，确认功能正常。Step 5：提交
帮我看看改动，创建合适的提交。关键要点
- 永远从 Brainstorming 开始：一个被充分讨论的需求能减少 80% 的返工
- Plan Mode 是中间层：在需求和代码之间的方案设计不可跳过
- 边做边验：每完成一个模块就运行测试，不要等到最后
5.2 Bug 定位与修复流程
工作流概览
复现 Bug → 定位根因 → 修复代码 → 添加回归测试 → 验证 → 提交
│ │ │ │ │ │
描述现象 Claude Claude Claude 运行 /commit
给 Claude 分析调用链 精准修复 写测试 测试实战演示
Bug 描述：用户登录后偶尔会跳转到 404 页面。
Step 1：描述现象
用户反馈登录后偶尔被重定向到 404 页面。帮我排查原因。
现象：
- 不是每次都发生
- 似乎是特定用户在特定时间出现
- 生产环境日志显示重定向 URL 中有多余的斜杠Step 2：Claude 排查
Claude Code 会：
- 读取登录相关的路由和重定向逻辑
- 分析 URL 拼接逻辑，找到 bug 根因
- 提出修复方案
Step 3：修复 + 回归测试
帮我修复这个 bug，并添加一个回归测试确保不会复发。Step 4：验证修复
运行相关测试，并手动确认修复逻辑正确。关键要点
- 给 Claude 尽可能多的信息：复现步骤、日志、截图、环境信息
- 让 Claude 先分析再动手："帮我分析原因" 和 "帮我修" 分两步
- 始终坚持加回归测试：这是 Bug 修复的最后一步，也是最容易被跳过的一步
5.3 代码审查流程
工作流概览
开发完成 → Claude 预审 → 人工复审 → 修改 → 合并
│ │ │ │ │
创建分支 /review 你审查 Claude merge
全面扫描 关键逻辑 按要求改实战演示
Step 1：让 Claude 预审
帮我审查当前分支的所有变更，重点关注：
- 安全性（SQL 注入、XSS）
- 性能问题
- 异常处理是否完整如果你安装了 code-review:code-review Skill，可以直接用：
/code-review:code-reviewStep 2：处理 Claude 的反馈
当 Claude 提出修改建议时：
把 Claude 的 review 意见逐条处理：合理的直接修复，不合理的说明原因。关键要点
- Claude 预审 + 人工复审：Claude 擅长发现模式问题、安全漏洞、遗漏的边界条件；人类负责业务逻辑正确性和设计一致性
- 给出审查重点：告诉 Claude 你关注什么方面，它的审查更有针对性
- 不要盲从：Claude 的审查意见也可能有误，尤其是业务逻辑相关的
5.4 项目重构/迁移流程
工作流概览
评估范围 → 制定迁移计划 → 分模块执行 → 持续验证 → 完成
│ │ │ │ │
Claude Plan 逐个模块 运行测试 /commit
分析项目 Mode 迁移 确认无回归实战演示
需求：将项目从 JavaScript 迁移到 TypeScript。
Step 1：评估
帮我分析这个项目迁移到 TypeScript 需要多大工作量，
哪些文件最复杂，建议的迁移顺序是什么。Step 2：制定计划
帮我制定一个 TypeScript 迁移计划。建议按模块逐步迁移，
先改类型定义和工具函数，再改组件。Step 3：分批执行
开始迁移 src/utils/ 目录。每迁移一个模块，立即运行测试确认无回归。
关键要点
- 大型迁移务必用 Plan Mode：了解全貌再动手
- 一次一个模块：大规模迁移最怕的就是改到一半发现方向错了
- Git 是安全网：每迁移一个模块就提交一次
- 切 Opus 模型：复杂迁移用最强模型
5.5 文档生成与维护
工作流概览
识别文档需求 → 生成初稿 → 人工补充 → 保持更新
│ │ │ │
Claude Claude 你补充 后续修改时
分析代码 写文档 业务细节 同步更新实战演示
场景 1：生成 API 文档
帮我把 src/api/ 下的所有路由生成 API 文档，包括请求参数、返回格式、错误码。场景 2：写 README
帮我写一个项目 README，包括：项目简介、技术栈、如何启动、目录结构说明。场景 3：更新 CLAUDE.md
项目最近重构了目录结构，帮我更新 CLAUDE.md。关键要点
- 文档也需审查：Claude 写的文档可能有不准确的地方，尤其是业务术语
- 保持同步：每次重构后顺带更新文档，不要让文档腐烂
- 用
/init生成 CLAUDE.md 初稿：然后手动精炼