基础代码协作

Claude Code 不只是个人工具，它也可以融入团队的开发流程——帮你写更好的提交信息、准备 PR、做代码审查，甚至统一团队的代码风格。

写好 Git 提交信息

好的提交信息能让你的团队理解每次改动的意图。

让 Claude Code 帮你写：

> 我刚实现了用户邮箱验证功能：
> - 注册时发送验证邮件
> - 24小时内需要点击链接完成验证
> - 未验证用户不能登录
> 帮我写一个符合 conventional commits 规范的提交信息

或者让它查看改动后再写：

> 看一下 git diff，帮我写一个提交信息
> 格式要求：conventional commits（feat:/fix:/chore: 等）
> 标题不超过 50 字符，有必要的话加上详细描述

---

准备 Pull Request

写 PR 描述

> 看一下我这个分支的改动（git diff main）
> 帮我写一个 PR 描述，包含：
> - 这个 PR 做了什么（3-5 个要点）
> - 为什么要这样改（背景/原因）
> - 怎么测试（测试步骤）
> - 有没有需要注意的地方

PR 自查清单

提交 PR 前让 Claude Code 帮你检查：

> 在我提交这个 PR 之前，帮我做一个自查：
> 1. 运行所有测试，确认没有失败
> 2. 检查有没有遗漏的边界情况
> 3. 看看有没有 console.log 或调试代码忘了删
> 4. 检查新加的代码有没有遗漏的错误处理
> 5. 确认代码风格符合 ESLint 规则

拆分大 PR

> 我的改动涉及多个功能，想拆成几个小 PR
> 看一下 git diff，建议怎么拆比较合理？
> 拆分原则：每个 PR 只做一件事，可以独立合并

---

代码审查

自我审查（提交前）

> 审查我刚写的这段代码：
> - 逻辑有没有问题
> - 有没有安全漏洞（注入、越权、敏感数据泄露等）
> - 性能有没有明显问题
> - 代码风格和项目规范是否一致

> 审查 src/api/payment.ts 这个文件
> 重点关注：支付相关的安全问题，比如金额校验、重复支付防御、错误处理

审查别人的代码

理解别人写的代码：

> 帮我理解这个 PR 的改动
> 分析一下：这个实现有没有什么潜在问题？有没有更好的方式？

---

生成和更新文档

生成函数文档

> 为 src/services/orderService.ts 里所有公开的函数生成 JSDoc 注释
> 包含：函数作用、参数说明（类型+含义）、返回值、可能抛出的错误

生成 API 文档

> 根据 src/api/routes/ 目录下的路由文件，生成 API 文档
> Markdown 格式，包含：路径、HTTP 方法、请求参数、响应格式、错误码

更新 README

> 项目的 README 已经过时了，帮我更新：
> 1. 看一下当前项目的实际情况（package.json、主要文件结构）
> 2. 更新安装步骤
> 3. 更新运行命令
> 4. 更新环境变量说明（参考 .env.example）

记录架构决策

> 我们刚决定把认证改成 JWT + Refresh Token 方案
> 帮我写一个架构决策记录（ADR）：
> - 背景和问题
> - 考虑过的方案（Session、JWT Only、JWT + Refresh Token）
> - 最终选择和理由
> - 权衡和注意事项

---

执行团队规范

检查代码是否符合规范

在 CLAUDE.md 里定义团队规范，让 Claude Code 帮你执行：

> 检查 src/components/ 下的 React 组件是否符合我们的规范：
> - Props 类型必须用 interface 定义（不用 type）
> - 必须有 displayName
> - 样式只能用 Tailwind，不允许 inline style
> - 所有组件必须有默认导出

批量格式化代码

> src/legacy/ 目录下的代码格式很混乱
> 帮我统一格式：
> - 2空格缩进
> - 单引号
> - 行尾分号
> - 按照 ESLint 规则修复所有警告

统一错误处理模式

> 代码里的错误处理方式不统一，有些用 try-catch，有些用 .catch()，有些直接忽略
> 帮我统一为 async/await + try-catch 的风格
> 错误处理模式参考 CLAUDE.md 里定义的规范

---

多人协作场景

接手别人的代码

> 我要接手维护 src/payments/ 模块
> 帮我做一个快速了解：
> - 这个模块的功能和边界
> - 主要的数据流
> - 已知的技术债务或 TODO
> - 有哪些地方需要特别小心

给新成员写接入文档

> 新成员要开始在这个项目上工作
> 帮我生成一个上手指南：
> - 环境搭建步骤
> - 项目结构说明
> - 开发流程（分支规范、测试、提交）
> - 常见问题和解决方法

---

在 Git 工作流中使用 Claude Code

Claude Code 了解你的 Git 状态，可以直接参与工作流：

# 查看改了什么
> 帮我总结今天的改动

# 解决冲突
> 我在合并分支时遇到冲突，帮我理解两边的改动，然后建议正确的合并方式

# 找出引入 bug 的提交
> users 表新增了一个 deleted_at 字段之后，用户列表就出问题了
> 帮我找一下最近的提交，哪个引入了这个问题

---

团队使用 Claude Code 的建议

统一 CLAUDE.md：把团队规范写进项目的 CLAUDE.md，每个人的 Claude Code 都会遵守同样的规则。

不替代代码审查：Claude Code 帮你自我审查是加速，但不能替代人工审查——人工审查能发现业务逻辑问题和架构问题。

培养使用习惯：让 Claude Code 成为每个开发步骤的一部分：写代码前规划、写完自我审查、提 PR 前检查。