摘要Agent 说「Done」只是自评改了哪些文件、有没有顺手误改还得你来确认。本文给出一份 5 分钟 Diff 验收清单先读总结 → 看改动范围main N→ 逐文件看 Diff左右 / 行内→ 同一任务追问 → 通过并合并 / 放弃改动并留痕并附一条可复用的 /review 提示词。终端最后一行写着「All tests pass. Done.」你差点就 push 了——然后发现它顺手改了一个你根本没让它碰的配置文件。这种事遇到一次就再也不敢把 Agent 的「完成」当真。可每次都从头 review 又太累。我后来给自己定了一份 5 分钟的验收清单这篇把它完整写出来顺便标上它在 Caravel 里分别对应哪个位置。先认识一下 CaravelCaravel 是本地优先的多 AI 编码 Agent 桌面工作台支持 Claude Code、Codex、OpenCode、pi、Grok、TRAE、Antigravity 等 Agent用你自己的账号。用 AI 写代码最磨人的往往不是生成而是终端散落、Diff 难审、并行任务难管——Caravel 把任务、进度、授权和 Diff 验收放在同一个工作台里。免费使用支持 macOS 与 Windows。官网可在线体验不用安装中文手册一步一图GitHub下载与版本记录本文相关章节查看结果并验收为什么「Done」不等于能合「完成」是自评。Agent 停止输出、说验证通过只代表它认为做完了。目标理解偏了、测试只跑了一半它的总结里未必会写。改动是散的。一个小需求可能动了三四个文件终端里滚过去的输出拼不出完整的改动范围。没看就合事后难追。合进去之后再发现问题就得回头翻记录、手动回滚成本远高于合之前多看 5 分钟。所以我的原则只有一句完成是 Agent 说的交付是你决定的。下面是 5 步清单。每一步都很短加起来大约 5 分钟。第 1 步先读总结不先看代码约 1 分钟在哪任务列表里状态为「待验收」的任务 → 对话区。很多人一上来就打开 Diff 逐行看其实顺序反了。先读 Agent 的总结手册里写得很清楚对话区会有它的执行计划、改了什么、验证结果。读的时候只问自己三个问题它理解的目标和我当初写的目标一致吗它说的「验证」具体验证了什么是跑了测试还是只是「看起来没问题」有没有它主动提到、但我没要求的改动这一步的意义是先建立预期。带着预期去看 Diff才知道哪里不对劲。第 2 步看改动范围数字比预期大就警惕约 30 秒在哪任务标题下方的分支按钮例如main 2。按钮上的数字是未提交的改动文件数。点开它会弹出 Git 菜单里面就有查看 Diff打开改动窗口后顶部还会显示文件总数和增删行数左侧列出所有被修改的文件。这一步不看内容只看范围我只让它改搜索逻辑为什么列表里出现了一个配置文件一个「加个提示文案」的需求为什么增删了上百行范围超出预期就是最值得停下来的信号。开头那个被顺手改掉的配置就是在这一步能被发现的。第 3 步逐文件看 Diff左右看结构、行内看细节约 2 分钟在哪Diff 窗口左侧文件列表逐个点。红色背景是删除的旧代码绿色背景是新增的代码。右上角可以切换两种显示方式左右修改前后左右对照适合看结构变化——函数签名变没变、分支逻辑有没有被整体替换上一张图就是左右模式。行内前后放在同一列适合看细节——某个默认值、某个占位文案到底改成了什么。我的习惯是核心逻辑文件用左右看一遍文案、配置、模板类文件切到行内快速扫。重点盯三类改动删掉的代码红色——它删的东西是不是别处还在用边界处理——空值、空字符串、大小写这些它说处理了代码里真的有吗和目标无关的文件——第 2 步发现的「多出来的文件」在这里确认是必要还是误改。看完点窗口右上角关闭回到任务。同一个菜单里还能提交、推送、切换分支详见手册的 Git 操作章节。第 4 步追问而不是重来约 1 分钟在哪同一个任务底部的输入框。大体对、细节差的时候最浪费的做法是关掉重开一个新任务、把背景重新讲一遍。直接在输入框写下问题就行手册里的例子是「按钮颜色再浅一点」在上面图 1 的输入框里我写的是「空关键词时直接返回原列表再补一条中文关键词的测试」。Agent 会在同一个任务里接着改之前的上下文都在。两个小技巧对话太长、想找它之前说过的某句话按⌘FWindows 为CtrlF在对话里查找。每一轮发消息都可以换 Agent 或模型之前的对话会一起带过去。想让另一个模型帮你复核一遍不用复制粘贴上下文。Agent 改完后回到第 1 步再过一遍即可——第二轮只看新增的部分通常一两分钟就够。第 5 步做决定并留下痕迹约 30 秒在哪任务右上角的按钮取决于任务的运行方式。隔离副本运行的任务右上角有通过并合并和放弃改动。符合预期就合并方向不对就放弃项目保持原样——放弃会再次确认操作不可撤销。直接在工作区运行的任务默认方式改动已经写进项目右上角只有完成按钮。所以如果你想「先看再决定」建议在设置里开启隔离副本再建任务。独立分支运行的任务在新建的分支上改动、提交推送不会自动合并需要到代码托管平台发起合并请求。要提交时在 Git 菜单点提交改动勾选这次要提交的文件没勾选的留到下次点AI 生成可以让所选 Agent 根据勾选的改动写一条提交信息默认格式feat/fix/refactor/docs/chore: 中文摘要。生成结果只是草稿改一下再提交。一条写清楚「改了什么、为什么」的提交信息就是这次验收最好的痕迹。附把清单存成提示词/review清单的价值在于每次都用。Caravel 的提示词可以设置别名比如/review之后在输入框输入/就能一键插入。我存的版本是让 Agent 在交付前先把验收材料准备好这样第 1 步读总结会快很多交付前请按以下格式汇报 1. 你理解的目标一句话 2. 改动文件清单每个文件一句话说明为什么要改 3. 哪些改动超出了原目标为什么 4. 你实际运行了哪些验证结果是什么 5. 还有哪些你不确定、需要我重点看的地方提示词里也可以用{{变量}}占位插入后按 Tab 依次填写比如把「原目标」做成变量。5 步速查先读总结目标对不对、验证了什么看范围分支按钮 main N数字比预期大就警惕逐文件看 Diff左右看结构行内看细节追问不重来同一任务输入框继续说⌘F找上下文做决定并留痕通过并合并 / 放弃改动 / 完成提交信息写清楚完成是 Agent 说的交付是你决定的。自己试一下先在体验版里把这 5 步点一遍真实界面、示例数据不用安装、不调用 Agent示例 Diff 可以直接点开在线体验版 · Diff 示例对照手册查看结果并验收下载与版本记录macOS / WindowsGitHub · yy36295238/caravel-agent你现在验收 Agent 改动时最常漏看的是哪一步欢迎在评论区聊聊。