<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>massimoyang (Massimo Yang)</title>
    <link>https://w2solo.com/massimoyang</link>
    <description/>
    <language>en-us</language>
    <item>
      <title>Agent 的改动去哪了？只用 Git 审查 Cursor / Claude Code 写的代码</title>
      <description>&lt;p&gt;用 Cursor、Claude Code 在自己的项目里写代码，Agent 跑完后对话框常常只写一个「完成」。动手审查之前，先有一个更基本的问题：&lt;strong&gt;改动到底在哪？&lt;/strong&gt; 这取决于 Agent 是怎么跑的，每种情况要对比的对象也不一样。下面是一套只用 Git 命令的流程，Cursor、Claude Code 或其他 Agent 都适用。&lt;/p&gt;
&lt;h2 id="1. 改动可能在三个地方"&gt;1. 改动可能在三个地方&lt;/h2&gt;&lt;table class="table table-bordered table-striped"&gt;
&lt;tr&gt;
&lt;th&gt;Agent 怎么跑的&lt;/th&gt;
&lt;th&gt;改动在哪&lt;/th&gt;
&lt;th&gt;跟什么比&lt;/th&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;在你当前目录里&lt;/td&gt;
&lt;td&gt;工作区里还没 commit 的文件&lt;/td&gt;
&lt;td&gt;&lt;code&gt;HEAD&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;在另一个 worktree 里&lt;/td&gt;
&lt;td&gt;那个 checkout 里未提交的文件，和/或已经提交的 commit&lt;/td&gt;
&lt;td&gt;那个 worktree 的 &lt;code&gt;HEAD&lt;/code&gt;，以及 &lt;code&gt;main&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;在云端（Cloud Agent、PR）&lt;/td&gt;
&lt;td&gt;远程分支上的 commit&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;main&lt;/code&gt;，从分叉点开始&lt;/td&gt;
&lt;/tr&gt;
&lt;/table&gt;
&lt;p&gt;有个细节容易搞混：Cursor 的 checkpoint 和 Claude Code 的 &lt;code&gt;/rewind&lt;/code&gt; 存在 Git 之外。它们用来撤销，但只读 Git 的工具看不到这段历史。Claude Code 自己的文档也写了：只通过 shell 命令改过的文件，&lt;code&gt;/rewind&lt;/code&gt; 不会恢复。Git 则能看到磁盘上的所有内容（&lt;code&gt;.gitignore&lt;/code&gt; 里的除外），不管是谁写的。&lt;/p&gt;
&lt;h2 id="2. 开工前先记下起点"&gt;2. 开工前先记下起点&lt;/h2&gt;
&lt;p&gt;在 Agent 要改的目录里：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git rev-parse &lt;span class="nt"&gt;--show-toplevel&lt;/span&gt;   &lt;span class="c"&gt;# 我现在在哪个仓库 / worktree&lt;/span&gt;
git rev-parse HEAD              &lt;span class="c"&gt;# 起始 commit&lt;/span&gt;
git status &lt;span class="nt"&gt;--short&lt;/span&gt;              &lt;span class="c"&gt;# 是不是已经有我自己的改动了？&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果 &lt;code&gt;status&lt;/code&gt; 是空的，之后出现的改动就都是 Agent 做的。如果不是空的，先记下哪些本来就是你的（或者先 commit / stash），否则同一个文件里，你分不清哪一段是你改的、哪一段是它改的。&lt;/p&gt;
&lt;h2 id="3. 工作区里的改动：别漏掉新建的文件"&gt;3. 工作区里的改动：别漏掉新建的文件&lt;/h2&gt;&lt;pre class="highlight shell"&gt;&lt;code&gt;git status &lt;span class="nt"&gt;--short&lt;/span&gt;
git diff &lt;span class="nt"&gt;--stat&lt;/span&gt; HEAD &lt;span class="nt"&gt;--&lt;/span&gt;
git ls-files &lt;span class="nt"&gt;--others&lt;/span&gt; &lt;span class="nt"&gt;--exclude-standard&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这里有个容易踩的点：&lt;code&gt;git diff&lt;/code&gt; &lt;strong&gt;不会显示未跟踪的文件&lt;/strong&gt;。Agent 新建的测试、迁移脚本或配置文件，在 &lt;code&gt;status&lt;/code&gt; 里只显示为 &lt;code&gt;??&lt;/code&gt;，而这些文件往往比旁边那一大段修改更能说明它做了什么。如果希望它们也出现在 diff 里，可以用 intent-to-add 标记：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git add &lt;span class="nt"&gt;-N&lt;/span&gt; path/to/new_file   &lt;span class="c"&gt;# 会进入 git diff，但内容不会进暂存区&lt;/span&gt;
git restore &lt;span class="nt"&gt;--staged&lt;/span&gt; path/to/new_file   &lt;span class="c"&gt;# 想撤销的话&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id="4. Worktree：先找到目录"&gt;4. Worktree：先找到目录&lt;/h2&gt;
&lt;p&gt;如果 Agent 是在另一个 worktree 里并行跑的，改动不在你当前这个目录：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git worktree list
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;输出会列出每个目录，以及对应的 commit 和分支。进到 Agent 那个目录里，把第 3 节的命令再跑一遍。它在这条分支上已经提交的 commit，从任何一个 worktree 都能看到，因为仓库是同一个。&lt;/p&gt;
&lt;h2 id="5. 分支：用 ...，不要用空格"&gt;5. 分支：用 &lt;code&gt;...&lt;/code&gt;，不要用空格&lt;/h2&gt;
&lt;p&gt;对 Agent 的分支（本地的，或已经 &lt;code&gt;git fetch origin&lt;/code&gt; 下来的）：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git log &lt;span class="nt"&gt;--oneline&lt;/span&gt; main..origin/agent
git diff &lt;span class="nt"&gt;--stat&lt;/span&gt; main...origin/agent
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;git diff&lt;/code&gt; 的两种写法差别很大：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;git diff main...agent&lt;/code&gt;（三个点）从 &lt;strong&gt;merge-base&lt;/strong&gt; 开始比，也就是这条分支从 &lt;code&gt;main&lt;/code&gt; 分出去的那个点。你看到的只是这条分支做了什么。&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;git diff main agent&lt;/code&gt;（中间是空格）直接对比两个分支的顶端。分叉之后进入 &lt;code&gt;main&lt;/code&gt; 的那些提交，会反过来显示，看起来就像 Agent 把它们删掉了。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;而且这两种写法都&lt;strong&gt;只比较已经提交的 commit&lt;/strong&gt;。如果 Agent 在那个 checkout 里还留了未提交的改动，它们不会出现。想一次看全，在这条分支的 checkout 里执行：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git diff &lt;span class="nt"&gt;--merge-base&lt;/span&gt; main   &lt;span class="c"&gt;# 从 merge-base 一直比到工作区（Git 2.30+）&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;（未跟踪的文件还是不会出现；回到第 3 节。）&lt;/p&gt;

&lt;p&gt;如果 Agent 用 rebase 或 force-push 重写了分支，不必整段重读。先在 &lt;code&gt;fetch&lt;/code&gt; 之前记下原来的 tip（&lt;code&gt;git rev-parse origin/agent&lt;/code&gt;），再对比新旧两串提交：&lt;/p&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git range-diff main &amp;lt;旧 tip&amp;gt; origin/agent
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;range-diff&lt;/code&gt; 会按相似度把新旧 commit 配对，只标出两版之间的差异。&lt;/p&gt;
&lt;h2 id="6. 按你提出的需求来分组"&gt;6. 按你提出的需求来分组&lt;/h2&gt;
&lt;p&gt;用一句话写下你当时让 Agent 做什么，然后把文件分成三类：&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;实现这个需求的文件。&lt;/strong&gt; 先读这些。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;调用这些函数的地方，以及测试。&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;其余所有：&lt;/strong&gt; 默认值、配置、依赖、lockfile、重命名。这里如果有对不上你需求的东西，就逐行读。&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;对最主要的那处行为变化，问三个问题：什么输入或状态会走到这段新代码？出错的路径上会发生什么？有没有测试真正覆盖到这个状态？&lt;/p&gt;
&lt;h2 id="7. 测试：看断言，别只看名字"&gt;7. 测试：看断言，别只看名字&lt;/h2&gt;
&lt;p&gt;留意被删掉、放宽、或改成 snapshot 的断言（&lt;code&gt;git diff HEAD -- '*test*'&lt;/code&gt; 可以用来过滤）。另外要记住，测试跑的是整个工作区：如果你打算用 &lt;code&gt;git add -p&lt;/code&gt; 只提交一部分改动，测过的和即将提交的就不是同一批东西。拆开之后再跑一遍测试（比如用 &lt;code&gt;git stash --keep-index&lt;/code&gt;，只留下已经进入暂存区的内容）。&lt;/p&gt;
&lt;h2 id="8. 提交前再看一眼"&gt;8. 提交前再看一眼&lt;/h2&gt;&lt;pre class="highlight shell"&gt;&lt;code&gt;git diff &lt;span class="nt"&gt;--cached&lt;/span&gt;          &lt;span class="c"&gt;# 完整读一遍：这就是要进 commit 的内容&lt;/span&gt;
git diff &lt;span class="nt"&gt;--cached&lt;/span&gt; &lt;span class="nt"&gt;--check&lt;/span&gt;  &lt;span class="c"&gt;# 行尾空格和冲突标记&lt;/span&gt;
git status &lt;span class="nt"&gt;--short&lt;/span&gt;         &lt;span class="c"&gt;# 还剩没有该加进来的 ?? 吗？&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;--check&lt;/code&gt; 只抓行尾空格和冲突标记，并不能证明行为是对的。&lt;/p&gt;
&lt;h2 id="9. 再请一位「第二意见」（可选）"&gt;9. 再请一位「第二意见」（可选）&lt;/h2&gt;
&lt;p&gt;另开一个会话，最好换一个模型，只读地审一遍 diff，经常能找出 Agent 总结里漏掉的东西。两条原则：每条结论都回到它指出的那一行核对；模型「建议」的测试，并没有人真正跑过。&lt;/p&gt;

&lt;hr&gt;

&lt;p&gt;&lt;strong&gt;声明：Yenpo 是我做的。&lt;/strong&gt; 如果你更想在 Mac 上用原生界面走这套流程：Yenpo 是一个免费的 Mac 应用，用来读懂和审查 AI Agent 在你自己项目里写的代码。它打开本地 Git 仓库，展示 commit、分支（从分叉点比，或尖端对尖端）以及未提交的改动，包括未跟踪的文件；代码导航用的是你这台机器上的 language server。AI Reader 是可选项，使用你自己的 AI 服务商。它默认只读：&lt;strong&gt;允许编辑&lt;/strong&gt;（Allow Edits）只对下一条发给 AI Reader 的消息有效，发完后重新回到只读。它不和 Claude Code、Codex、Cursor 或 GitHub 集成，只读取本地 Git 仓库。&lt;a href="https://yenpo.app/?utm_source=w2solo&amp;amp;utm_medium=article&amp;amp;utm_campaign=test_post" rel="nofollow" target="_blank"&gt;https://yenpo.app/?utm_source=w2solo&amp;amp;utm_medium=article&amp;amp;utm_campaign=test_post&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;你们平时怎么审查 Agent 的改动：直接看工作区、看单独的 worktree，还是只在 PR 里看？&lt;/p&gt;</description>
      <author>massimoyang</author>
      <pubDate>Tue, 17 Nov 2026 20:49:18 +0800</pubDate>
      <link>https://w2solo.com/topics/8734</link>
      <guid>https://w2solo.com/topics/8734</guid>
    </item>
    <item>
      <title>Yenpo</title>
      <description>&lt;p&gt;大家好，我是 Massimo Yang，一个人在做 Yenpo，这是我的个人项目。&lt;/p&gt;

&lt;p&gt;做它的原因很简单：和 Claude Code、Codex 这类 agent 一起写项目时，AI 干完活会给一段总结和一大片 diff，总结说的是它想做什么，diff 才是它实际做了什么，两者不一定对得上。扫一眼就合并，其实不算 review。Yenpo 就是帮你在和 AI 一起写项目的过程中，把它写的代码读懂、审一遍，跟上它的思路。它不是用来读别人开源仓库的。&lt;/p&gt;

&lt;p&gt;能做什么：&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;看三种改动：单个 commit、分支对比 main、未提交的本地改动（含新建的未跟踪文件），行内 diff。&lt;/li&gt;
&lt;li&gt;通过本机语言服务器跳转定义、查找引用（Swift、Rust、C/C++/ObjC、Python、JS/TS、Go），还有全文搜索。&lt;/li&gt;
&lt;li&gt;可选的 AI Reader，用你自己的模型服务商，会列出它读了哪些文件、搜了什么，回答里的 文件:行号 能点开核对。AI Reader 默认只读，Allow Edits 只对下一条消息生效。&lt;/li&gt;
&lt;li&gt;内置终端，编辑器带补全和格式化。&lt;/li&gt;
&lt;li&gt;Rust 项目默认不跑 build.rs 和过程宏，点 "Trust and enable Rust development" 之后才开。&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;它不和任何 agent、编辑器或 GitHub 集成，直接读取本地的 git 仓库，所以你用什么 agent 都行。&lt;/p&gt;

&lt;p&gt;技术上是 SwiftUI 外壳 + Rust 核心。核心放在 Rust 里是为了以后跨平台；现在只有 Mac 版，只是因为我自己用 Mac 工作，没有 Windows 环境。&lt;/p&gt;

&lt;p&gt;macOS 14+，Universal 版本，界面 10 种语言（含简体中文）。免费，不用注册账号，App 内没有遥测。&lt;/p&gt;

&lt;p&gt;想请大家说说真实感受：哪里让你困惑、缺了什么、要改成什么样你才会真的用它。欢迎直接回帖。&lt;/p&gt;</description>
      <author>massimoyang</author>
      <pubDate>Sat, 31 Oct 2026 09:52:11 +0800</pubDate>
      <link>https://w2solo.com/topics/8657</link>
      <guid>https://w2solo.com/topics/8657</guid>
    </item>
  </channel>
</rss>
