标注 AI Diff
Annotate AI Diff 是 DevAgent 针对 agent 生成代码的行内审查循环。你可以在任意 AI 生成 hunk 的任意一行上留下评论,然后把它们作为一个批次发回给 agent 进行修订——不用复制行号,也不用来回切换上下文。
留下评论
- 将鼠标悬停在 diff 中的任意一行上。装订线处会出现一个 +。
- 点击它(或在光标位于该行时按
c)。 - 输入你的反馈——支持 markdown。
- 按
Cmd-Enter保存,按Esc取消。
评论会固定在确切的行上;DevAgent 会在多次编辑之间跟踪它们,即便 diff 发生位移,评论也会跟着对应的行走。
发送批次
审查完成后,点击 diff 顶部的 Send to agent。DevAgent 会把你所有的评论组合成一个 prompt,每条都锚定到对应行,然后打开一个 Send notes to 菜单,列出该 worktree 可用的 agent。选择应当负责修订该改动的 agent,或者从同一个菜单启动一个新的 agent。
Send Review Notes to Agent 默认没有绑定按键,因此不会与其他快捷组合键冲突。你可以在 设置 → 快捷键 中为它分配快捷键,从而用键盘打开那个发送菜单(即使编辑器处于聚焦状态也可用)。
为什么要批量发送?
一次只发一条评论会让 agent 来回摇摆。批量发送能让反馈保持连贯:一轮思考、一遍修订,命中率也高得多。
回复、解决、再审查
- agent 修订之后,评论仍会保持固定——可以用它们来验证修复是否到位。
- 点击 Resolve 可以折叠一个评论线程。
- 如果你再次点击 Send,未解决的评论会被纳入下一个批次。