AI Agent / 系统课时
协作 Git 变更
协作 Git 变更
本课把 Claude Code 放进日常 Git 协作链路:先读取工作区事实,再按变更意图整理提交,生成可审阅的提交说明和拉取请求内容,最后把真正会影响共享仓库的动作留在明确确认之后。
学习目标
- 能让 Claude Code 基于真实 diff 解释当前变更,而不是凭任务描述猜测
- 能把混杂修改拆成意图单一、可审阅、可回滚的提交
- 能根据提交与测试证据准备准确的提交说明和拉取请求正文
先看清工作区再讨论提交
协作的第一步不是让 Claude “帮我提交”,而是确定工作区里到底有什么。先检查已修改、已删除和未跟踪文件,再让 Claude 阅读 diff,区分本次任务修改、用户未完成的其他工作以及不应进入版本库的生成物或敏感文件。
git status --short预期输出
M <PATH>
?? <PATH>当工作区存在修改和未跟踪文件时,输出通常由这类状态码与实际路径组成;干净工作区可能没有输出。<PATH> 应替换为当前仓库中的真实文件。
给 Claude Code 的审阅提示词可以直接限定为只读分析:
先不要暂存、提交或丢弃任何文件。
读取 git status 和当前 diff,按以下结构说明:
1. 每组变更的意图
2. 可能属于其他任务的文件
3. 缺失的测试或验证
4. 不应纳入提交的生成物、密钥或临时文件这样能避免把“看起来相关”误当成“应该一起提交”。
把混杂变更拆成可审阅单元
一个提交最好表达一个完整意图,例如“修复会话过期判断”或“补充该缺陷的回归测试”。如果工作区同时包含重构、格式化和功能修改,让 Claude 先提出分组方案,再由你确认哪些文件或补丁块进入当前提交。
根据当前 diff 设计最小提交方案。
每个提交只表达一个意图,并列出应包含的文件或补丁块、对应测试、
以及为什么这些内容必须放在同一个提交中。
不要执行 git add、git commit、reset、restore 或 push。分组时特别关注三类风险:无关格式化会放大审阅噪声,生成文件可能掩盖真正源码差异,凭据和本地配置则可能造成泄漏。Claude 可以协助识别,但最终应以仓库规范和实际 diff 为准。
理解从工作区到拉取请求的状态链
Git 协作并不是“改完代码就有一个 PR”,中间至少经过工作区、暂存区、提交和远端分支几个状态。Claude Code 可以在每个节点帮助解释差异、组织信息或执行 Git 操作,但越接近共享远端,越需要明确检查点。

在准备提交前,应重新查看暂存差异,而不是仅凭工作区 diff 记忆内容;在准备 PR 前,应基于已经形成的提交和测试结果重新总结,而不是沿用最初任务描述。每推进一个状态,都重新读取当前事实。
让提交说明描述意图而不是文件清单
好的提交说明回答“为什么改”和“行为改变了什么”,而不是重复“修改了三个文件”。Claude 应先观察仓库近期提交风格,再按团队约定起草;如果团队采用 Conventional Commits,可以继续沿用,否则不要强行套格式。
fix(auth): reject expired session token
Keep valid sessions unchanged and add a regression test for expired tokens.这只是格式示例,不应直接复制到无关仓库。实际消息必须来自当前 diff;如果 Claude 无法从变更中解释影响,就说明提交边界或上下文还不够清楚。
准备拉取请求内容并保留确认点
PR 正文应比提交消息多一层审阅信息:变更背景、实现方式、测试证据、风险与需要关注的区域。Claude Code 支持直接创建 PR,但在团队仓库里,更稳妥的做法是先让它生成内容并审阅,再决定是否执行会对远端可见的操作。
基于当前分支的实际提交准备 PR 内容,但不要创建或 push。
输出:
- 一个简洁标题
- 为什么需要这个改动
- 主要实现点
- 已运行的测试与结果
- 风险、兼容性或需要 reviewer 特别关注的地方
不要声称执行过没有实际运行的测试。确认正文准确后,再按团队流程暂存、提交、推送或创建 PR。Claude Code 也能配合 gh 创建拉取请求;如果使用这条路径,远端提交、PR 创建等共享动作应在执行前明确确认,而不是把“准备内容”和“发布内容”混成一步。
协作 Git 变更的核心是让 Claude 始终基于当前仓库状态说话:先读 status 和 diff,再形成提交边界,再用真实提交和测试证据写消息与 PR。这样 Claude 是审阅与整理的加速器,而不是绕过版本控制检查点的自动提交器。