场景：功能开发与 Bug 修复

在现有项目中，用 Claude Code 添加功能或修复 Bug。

功能开发流程

理解需求 → 定位相关代码 → 规划方案 → 逐步实现 → 补测试 → 审查

1. 让 AI 先理解项目

如果是刚接手的项目：

> 分析这个项目的结构、技术栈和核心业务逻辑
> /init

2. 添加功能

> 给文章添加标签系统：
> - Post 和 Tag 多对多关系
> - 创建/管理标签的 API
> - 文章列表支持按标签筛选
> - 文章详情页显示标签
> - 标签管理页面（仅管理员）
> 使用现有的代码风格和目录结构。

要点：描述功能需求 + 约束（复用现有风格），不用描述实现细节。

3. 分步确认

> 先只做数据模型和 API，不要动前端
> ...确认后...
> 现在做前端部分
> ...确认后...
> 补集成测试

Bug 修复流程

复现问题 → 定位代码 → 分析根因 → 修复 → 回归测试

场景：线上错误

> 线上 500 错误，日志如下：
> TypeError: Cannot read properties of undefined (reading 'id')
>     at UserController.getUser (src/controllers/user.ts:42)
>     at async handler (src/middleware/async.ts:15)
> 偶发，不是每次都出现。

Claude Code 会：读取出错代码 → 分析 undefined 的条件 → 检查上游调用 → 修复 + 防御性检查 + 回归测试。

场景：测试失败

> 运行 npm test，有 3 个测试失败：
> 1. UserAPI.test.ts:45 — 注册时邮箱重复返回 500 而非 409
> 2. PostAPI.test.ts:78 — 分页 offset 计算错误
> 3. Auth.test.ts:23 — token 过期后未返回 401
> 逐个分析原因并修复。

场景：性能问题

> GET /api/posts 接口响应 3 秒。
> 检查是否有 N+1 查询、缺少索引、不必要的全量加载。
> 找到瓶颈后优化。

功能开发速查

场景	提示要点
加字段	指定字段名、类型、约束、影响的页面和 API
加接口	指定路由、请求/响应格式、权限、错误码
加页面	指定路由、交互、数据来源、复用的组件
加中间件	指定触发条件、处理逻辑、错误处理
性能优化	给出当前指标和目标，指出怀疑的瓶颈

Bug 修复速查

场景	提示要点
线上报错	贴完整错误栈 + 偶发/必现 + 环境
测试失败	贴测试名 + 实际结果 vs 期望结果
数据异常	描述期望数据 vs 实际数据 + 触发条件
性能问题	给量化指标（当前 X 秒，目标 Y 秒）

通用技巧

• 让 AI 先读代码理解上下文，再提修改要求
• 修改后运行 /review + 测试确认
• 修复 Bug 后必须补回归测试
• 用 /compact 保留关键上下文（如 Bug 相关讨论）