分享发现 Agent 的改动去哪了?只用 Git 审查 Cursor / Claude Code 写的代码
用 Cursor、Claude Code 在自己的项目里写代码,Agent 跑完后对话框常常只写一个「完成」。动手审查之前,先有一个更基本的问题:改动到底在哪? 这取决于 Agent 是怎么跑的,每种情况要对比的对象也不一样。下面是一套只用 Git 命令的流程,Cursor、Claude Code 或其他 Agent 都适用。
1. 改动可能在三个地方
| Agent 怎么跑的 | 改动在哪 | 跟什么比 |
|---|---|---|
| 在你当前目录里 | 工作区里还没 commit 的文件 | HEAD |
| 在另一个 worktree 里 | 那个 checkout 里未提交的文件,和/或已经提交的 commit | 那个 worktree 的 HEAD,以及 main
|
| 在云端(Cloud Agent、PR) | 远程分支上的 commit |
main,从分叉点开始 |
有个细节容易搞混:Cursor 的 checkpoint 和 Claude Code 的 /rewind 存在 Git 之外。它们用来撤销,但只读 Git 的工具看不到这段历史。Claude Code 自己的文档也写了:只通过 shell 命令改过的文件,/rewind 不会恢复。Git 则能看到磁盘上的所有内容(.gitignore 里的除外),不管是谁写的。
2. 开工前先记下起点
在 Agent 要改的目录里:
git rev-parse --show-toplevel # 我现在在哪个仓库 / worktree
git rev-parse HEAD # 起始 commit
git status --short # 是不是已经有我自己的改动了?
如果 status 是空的,之后出现的改动就都是 Agent 做的。如果不是空的,先记下哪些本来就是你的(或者先 commit / stash),否则同一个文件里,你分不清哪一段是你改的、哪一段是它改的。
3. 工作区里的改动:别漏掉新建的文件
git status --short
git diff --stat HEAD --
git ls-files --others --exclude-standard
这里有个容易踩的点:git diff 不会显示未跟踪的文件。Agent 新建的测试、迁移脚本或配置文件,在 status 里只显示为 ??,而这些文件往往比旁边那一大段修改更能说明它做了什么。如果希望它们也出现在 diff 里,可以用 intent-to-add 标记:
git add -N path/to/new_file # 会进入 git diff,但内容不会进暂存区
git restore --staged path/to/new_file # 想撤销的话
4. Worktree:先找到目录
如果 Agent 是在另一个 worktree 里并行跑的,改动不在你当前这个目录:
git worktree list
输出会列出每个目录,以及对应的 commit 和分支。进到 Agent 那个目录里,把第 3 节的命令再跑一遍。它在这条分支上已经提交的 commit,从任何一个 worktree 都能看到,因为仓库是同一个。
5. 分支:用 ...,不要用空格
对 Agent 的分支(本地的,或已经 git fetch origin 下来的):
git log --oneline main..origin/agent
git diff --stat main...origin/agent
git diff 的两种写法差别很大:
-
git diff main...agent(三个点)从 merge-base 开始比,也就是这条分支从main分出去的那个点。你看到的只是这条分支做了什么。 -
git diff main agent(中间是空格)直接对比两个分支的顶端。分叉之后进入main的那些提交,会反过来显示,看起来就像 Agent 把它们删掉了。
而且这两种写法都只比较已经提交的 commit。如果 Agent 在那个 checkout 里还留了未提交的改动,它们不会出现。想一次看全,在这条分支的 checkout 里执行:
git diff --merge-base main # 从 merge-base 一直比到工作区(Git 2.30+)
(未跟踪的文件还是不会出现;回到第 3 节。)
如果 Agent 用 rebase 或 force-push 重写了分支,不必整段重读。先在 fetch 之前记下原来的 tip(git rev-parse origin/agent),再对比新旧两串提交:
git range-diff main <旧 tip> origin/agent
range-diff 会按相似度把新旧 commit 配对,只标出两版之间的差异。
6. 按你提出的需求来分组
用一句话写下你当时让 Agent 做什么,然后把文件分成三类:
- 实现这个需求的文件。 先读这些。
- 调用这些函数的地方,以及测试。
- 其余所有: 默认值、配置、依赖、lockfile、重命名。这里如果有对不上你需求的东西,就逐行读。
对最主要的那处行为变化,问三个问题:什么输入或状态会走到这段新代码?出错的路径上会发生什么?有没有测试真正覆盖到这个状态?
7. 测试:看断言,别只看名字
留意被删掉、放宽、或改成 snapshot 的断言(git diff HEAD -- '*test*' 可以用来过滤)。另外要记住,测试跑的是整个工作区:如果你打算用 git add -p 只提交一部分改动,测过的和即将提交的就不是同一批东西。拆开之后再跑一遍测试(比如用 git stash --keep-index,只留下已经进入暂存区的内容)。
8. 提交前再看一眼
git diff --cached # 完整读一遍:这就是要进 commit 的内容
git diff --cached --check # 行尾空格和冲突标记
git status --short # 还剩没有该加进来的 ?? 吗?
--check 只抓行尾空格和冲突标记,并不能证明行为是对的。
9. 再请一位「第二意见」(可选)
另开一个会话,最好换一个模型,只读地审一遍 diff,经常能找出 Agent 总结里漏掉的东西。两条原则:每条结论都回到它指出的那一行核对;模型「建议」的测试,并没有人真正跑过。
声明:Yenpo 是我做的。 如果你更想在 Mac 上用原生界面走这套流程:Yenpo 是一个免费的 Mac 应用,用来读懂和审查 AI Agent 在你自己项目里写的代码。它打开本地 Git 仓库,展示 commit、分支(从分叉点比,或尖端对尖端)以及未提交的改动,包括未跟踪的文件;代码导航用的是你这台机器上的 language server。AI Reader 是可选项,使用你自己的 AI 服务商。它默认只读:允许编辑(Allow Edits)只对下一条发给 AI Reader 的消息有效,发完后重新回到只读。它不和 Claude Code、Codex、Cursor 或 GitHub 集成,只读取本地 Git 仓库。https://yenpo.app/?utm_source=w2solo&utm_medium=article&utm_campaign=test_post
你们平时怎么审查 Agent 的改动:直接看工作区、看单独的 worktree,还是只在 PR 里看?