分享发现 Agent 的改动去哪了?只用 Git 审查 Cursor / Claude Code 写的代码

massimoyang(Massimo Yang) · 2026年11月17日 · 7 次阅读

用 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 做什么,然后把文件分成三类:

  1. 实现这个需求的文件。 先读这些。
  2. 调用这些函数的地方,以及测试。
  3. 其余所有: 默认值、配置、依赖、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 里看?

暂无回复。
需要 登录 后方可回复, 如果你还没有账号请 注册新账号