审查 pull request
通过 PR 评论触发审查
- 在处于打开状态的 GitHub pull request 或 GitLab 合并请求中,发布一条新评论:
/devin review。 - 点击 Devin 回复中的链接。先阅读概述,再打开一组相关更改,了解它们之间的关联。
- 在分析侧边栏或 缺陷 视图中,选择一个发现项并对照代码进行核实。如需更多上下文,可将其引用到聊天中。你可以自行修复代码,也可以让 Devin 进行编辑。
/devin review 用于请求分析。而 /devin fix the failing test 这类评论则会让 Devin 会话直接在该 PR 上执行任务。GitHub 请参阅通过 PR 评论启动 Devin,GitLab 请参阅通过 MR 评论启动 Devin。
打开审查的其他方式
- 从 Devin 打开: 打开 Devin Review,然后选择一个由你创建、分配给你或请求你审查的 PR。你也可以将 PR URL 粘贴到 PR 链接字段中,GitHub Enterprise 和 Azure DevOps 的 PR 同样适用。对于 GitHub.com 上的 PR,可以省略
https://,也可以使用owner/repo#123格式。 - 从 GitHub.com 打开: 将 PR URL 中的
github.com替换为devinreview.com。查看公开 PR 无需 Devin 账户;查看私有 PR 则需使用具有访问权限的账户登录。 - 从 Devin 会话打开: 在 PR 卡片上选择 Analyze。如果卡片同时提供 Analyze once 和 Analyze,选择 Analyze once 即可进行单次审查;选择 Analyze 还会在此 PR 后续每次推送时自动启用审查。
Cmd 或 Ctrl 键点击。
在列表中,按 j 或 k 选中下一个或上一个 PR,按 o 或 l 在窗格中打开该 PR,按 Enter 则打开其完整的审查页面。在 PR 允许的情况下,按 a 可批准该 PR 并跳转到下一个,按 m 可合并该 PR (或将其加入合并队列) 并跳转到下一个。这些列表快捷键与 PR 页面快捷键不同。
Devin Review 实际演示
阅读审查
先阅读概述,了解该 PR 改变了哪些行为。在 Guide view 中,按组阅读 diff:一个组可以将来自不同文件的相关改动归集在一起。当 Devin 检测到复制或移动的代码时,会直接显示为移动,而不是先显示删除、再显示一段相同内容的添加。 缺陷捕手 的发现项会显示在分析侧边栏或 缺陷 视图中。你可以在聊天中就该 PR 提问,并获得结合代码库其他部分相关上下文的解答;也可以直接在 diff 视图中的任意评论、缺陷或标记上询问 Devin。 在移动端,审查默认打开 Changes。切换到 缺陷 可查看缺陷、标记和安全 findings;如需了解该 PR 的其他详情,可查看 Description、Discussion 和 Commits。 在 Devin Review 中打开指向 GitHub 评论或审查的 link 时,页面会自动滚动到目标位置并高亮显示。该功能在 Devin 会话内的审查选项卡中同样有效;在该选项卡中,指向 PR diff 中某个文件的 GitHub 链接也会直接定位到该文件。 如果上次审查之后又推送了新的提交,且没有任何规则对其进行审查,页面会显示 Devin hasn’t analyzed the latest changes 横幅,注明最后审查的 commit 以及新增提交的数量。Analyze latest 会对当前 commit 再运行一次审查,但不会开启 auto-review;Analyze automatically 则可为此 pull request 或你创建的所有拉取请求开启 auto-review;如果你有权管理该代码仓库的审查设置,还可为该代码仓库中的所有 pull request 开启。在 Devin 会话内的审查选项卡中,See changes 会显示自上次审查以来推送的内容。 当有更新的审查结果时,New commit 会切换到审查页面打开期间推送的 commit;View latest commit 会针对 Review 已知的某个 commit 切换到更新后的 diff;New analysis 则会更新分析结果,但不会切换当前显示的 commit。浏览更改与审查历史
- 将文件标记为 Viewed 以跟踪审查进度,也可以在文件列表中将所有文件一键标记为已查看或未查看。
- 可展开更改周围的上下文行;也可以使用文件标头中的 Expand all lines 显示整个文件,再用 Collapse expanded lines 将其重新折叠。Markdown 文件可在渲染后的 diff 与源码之间切换。
- 在 diff 新版本一侧选中若干行后,可选择 Add to Chat;也可以选择 Suggest change,在这些行上创建一条审查评论,评论中会预填一个包含这些行当前文本的建议块。
- 隐藏仅涉及空白字符的更改,专注于实质性修改。
- PR 标头和 Review 列表中的行数默认不计入测试和生成的代码。将鼠标悬停在行数上可查看按类别划分的明细,并可在其中选择 Relevant、Both 或 Full 来切换显示的行数。点击行数则会在这三种显示方式之间循环切换。你的选择会同时应用于这两处。
- 按
Cmd+F或Ctrl+F可在审查内容中搜索。查找框中的过滤器图标提供 Match case、Changed lines only 和 Skip collapsed files 选项。默认情况下,无论文件是否已标记为已查看,搜索都会跳过已折叠文件的内容,但文件名和文件夹名仍会参与匹配。 - 使用标头操作菜单中的 Analysis history 查看较早的分析。在 Select commits to view 中,可以倒转已审查提交的排列顺序。在 GitHub 上,该选择器还会显示与这些提交关联的审批和更改请求。锁定到旧 commit 的链接不会自动显示最新结果;如果可用,请使用 Switch to latest 或 Run analysis on latest。
- 在 Checks 视图中查看 CI 状态。在支持此功能的提供商上,无需离开 Review 即可管理审查者、标签和经办人。
- diff 设置菜单中提供 Layout 选项:File tree view 会将未分组的 diff 与文件树一并显示,Guide view 则会将相关更改分组并附上说明。
生成文件与 diff 大小限制
在您的 Git 代码仓库根目录的.gitattributes 中标记为 linguist-generated 的文件,不计入 Devin Review 的 diff 大小限制。审查结果会显示这些文件新增和删除的行数,但不会分析其中的更改。
Devin Review 从 PR 的 head commit 读取 .gitattributes,因此在某个 PR 中添加的规则会作用于该 PR 自身的审查。自定义审查者和 Autoapprover 仅遵循合并基准 (用于生成 PR diff 的共同祖先) 上已有的规则,因此 PR 无法借此让自身的文件绕过它们的检查。例如,要将 src/generated/ 下的文件标记为生成文件,请在根目录的 .gitattributes 中添加以下规则:
缺陷捕手
缺陷捕手 会分析你的 PR (pull request 合并请求) ,查找潜在问题。结果包括 缺陷、标记 和 安全。Beta 版自定义审查者会单独给出各自的发现项。 如果某个 Devin 会话创建该 PR 是为了修复代码扫描发现的问题,嵌入式审查中会另有一个 Finding 或 Findings 选项卡,用于显示这些已关联的发现项。只要你有权访问这些发现项,该选项卡就会出现在 Review 或 Inbox 窗格以及该会话的 PR 选项卡中。缺陷
Devin 会将可能存在的错误标记为缺陷。请优先排查严重缺陷,它们带有红色缺陷图标;严重程度较低的缺陷则带有橙色警告图标。如有相关内容,可展开 Learn more 查看故障场景和建议的修复方案。复制按钮会一并复制位置、说明以及所有建议的修改。标记
待调查标记表示对代码存在疑问:请先检查被标记的代码行,再决定是否需要修复。信息性标记用于解释某项更改,不要求你进行修复。安全
Devin Review 会扫描安全漏洞,并将其与其他发现项一起显示。安全扫描是完整审查的一部分;你可以使用发布设置来控制是否将安全 findings 作为 PR 评论发布。仅针对 diff 的分析 (例如因达到支出限额而暂停自动审查时) 不算作完整的安全审查。 扫描器默认检查以下漏洞类别:- 注入 (SQL、XSS、命令、模板)
- 认证缺陷 (访问控制缺失/失效、权限提升、认证绕过)
- secrets 泄露 (硬编码密钥、日志中的令牌、源代码中的凭据)
- SSRF 和路径遍历
- 不安全的反序列化、原型污染
- 对不受信任数据缺少输入验证
- 弱加密 (算法、密钥管理)
- 传输/Cookie 安全 (未强制使用 HTTPS、过于宽松的 CORS、不安全的 Cookie 标志)
- PR 引入的不安全默认设置或错误配置
- 严重 — 高置信度 漏洞,应在合并前修复
- 警告 — 值得进一步调查的潜在 安全弱点
REVIEW.md 中添加安全策略、敏感区域或威胁模型,以指导扫描器重点检查哪些内容。
如果代码仓库提供了安全模型上下文,内置审查以及标记为 Security-related 的自定义审查者还会读取代码仓库根目录下的 SECURITY_MODEL.md、THREAT_MODEL.md,以及 SECURITY.md 中有关威胁模型或安全模型的章节。
下次推送时会发生什么?
当 Devin 审查已审查过的 PR 的新推送时,通常会查找自上次审查以来的更改所引入或影响的 bug。它会沿用之前的发现项,并检查新的提交是否已修复这些问题。如果新的提交大幅改变了 PR 的功能,或者新的 diff 过大、无法进行增量审查,Devin 可能会重新审查整个 PR。 每个 PR 的 auto-review 消耗上限按该 PR 的所有审查累计计算,而非针对每次推送单独计算。达到该上限后,该 PR 后续的自动审查将暂停,手动审查不受影响。审查评论语言
你可以在 Settings > Preferences 的 Devin Review 部分,选择 Devin Review 生成评论和分析时使用的语言。- 跟随显示语言 (默认) — 审查评论会遵循你的显示语言设置。
- 特定语言 — 从 Comment language 下拉菜单中选择一种语言,审查评论将改用该语言,而不是你的显示语言。
处理审查结果
处理发现项
缺陷 选项卡按后续待办状态列出发现项:- Needs your attention — 等待你分诊的 Open 发现项。
- Devin is fixing — 该 PR 的 Devin 会话正在处理的发现项。请参阅 自动修复。
- Fixed — 由你或 Devin 标记为已修复并关闭的发现项。
- Invalidated — 由你或 Devin 判定无需修复并关闭的发现项。
评论与审查
在 GitHub 上,你可以直接在 Devin Review 中发表评论、批准 PR 或请求更改。其他托管平台请参阅提供商参考。发起审查
当你撰写顶层评论、新的内联评论,或回复现有会话线程时,提交按钮提供两种操作:Start a review 会将你的评论汇总到一个待提交的审查中,而不是逐条发布;Comment 则会立即发布评论。Devin Review 会记住你上次选择的操作并将其设为默认,Cmd+Enter 或 Ctrl+Enter 快捷键也同样适用。审查开始后,按钮会变为 Add to review,之后的评论都会加入该审查,直到你提交为止。这是你给作者的审查,而不是请求 Devin 再做一次分析。
解决评论
讨论会话线程中的问题处理完毕后,请将该会话线程标记为已解决。在 GitHub 上,当机器人发布的审查中所有会话串均已解决时,Devin 会将该审查折叠;如果有会话线程被重新打开,Devin 会再次显示该审查。代码所有者标识
如果 sidebar 中某位审查者旁边显示盾牌图标,表示该审查者是作为代码所有者被请求审查的。通过聊天生成代码修改
让聊天智能体进行代码编辑。查看建议的代码修改,然后将其作为一次 commit 应用到 PR 分支,无需离开 Devin Review。这与自动修复不同,后者通过 Devin 会话来处理发现项。PR 工作流程操作
Devin Review 让你无需切换到 GitHub,即可直接在 Review 页面对 PR 执行操作。- Merge — 使用代码仓库允许的任意合并方式 (merge commit、squash 或 rebase) 合并 PR。如果允许多种方式,可在合并按钮的下拉菜单中选择;Devin Review 会在你的浏览器中记住你在该代码仓库和基础分支上的上一次选择。合并按钮会显示 PR 当前是否可合并,以及必需检查的状态。
- Close — 关闭 PR 而不合并。可在合并按钮旁边的下拉菜单中使用。
- Convert to draft — 将打开的 PR 转为草稿状态。当 PR 处于打开状态且尚未是草稿时,可在下拉菜单中使用。
- Mark ready for review — 将草稿 PR 标记为可供审查。对于草稿 PR,合并栏中会显示“准备好接受审查”按钮;该按钮的菜单中还提供 Review draft 选项,可在不将 PR 标记为就绪的情况下直接开始审查。
- Auto-merge — 在合并按钮的下拉菜单中启用或禁用 GitHub 自动合并。启用后,PR 会在所有必需检查通过后自动合并。合并栏会显示当前的自动合并状态,包括启用人。
键盘快捷键
m 和 n 会立即执行,效果与对应的按钮相同,因此按下 m 会直接合并,不会弹出确认。如需更改快捷键绑定,请前往 设置 > 键盘快捷键。
堆叠 PR
Devin Review 将堆叠 PR作为一等功能支持。当 PR 属于某个堆叠时,Review 页面会显示整个序列,并正确处理合并:- 堆叠面板 — PR 标头会显示整个堆叠,所有成员按从下到上的顺序排列,直至其要合并到的基础分支。每个成员都链接到各自的 Review 页面,因此你可以逐层查看堆叠。点击堆叠数量旁的 Reverse stack order 可改为将基础分支排在最前,系统会记住你的选择。
- 逐层就绪状态 — 每个成员都会显示一个状态点,反映其实际的可合并状态:实际可以合并时显示绿色 (已考虑 CI、必需审查和分支保护) ;检查失败或存在冲突时显示红色;其他任何阻碍合并的情况显示橙色——包括某一层本身已就绪,但受其下方无法合并的 PR 阻碍的情况。汇总指示器会概括整个堆叠的状态。
- 聚焦 diff — 堆叠中的每个 PR 都会与其下方一层进行 diff,因此每次审查——包括自动审查和缺陷捕手——都只会看到该层的变更。
- 堆叠合并 — 堆叠 PR 通过 GitHub 的原子堆叠合并进行合并:合并一个 PR 时,也会在一次操作中自下而上合并堆叠中位于其下方的所有打开的 PR。合并按钮会准确显示该操作将合并多少个 PR,之后 GitHub 会将其余 PR 的目标分支重新设为基础分支。
- 自动合并 — 你可以为堆叠 PR 启用 GitHub 自动合并。堆叠就绪后,GitHub 会合并该 PR 及其下方所有尚未合并的 PR。
提交与评论归属
- Bug 发现、标记和自动注释始终以 Devin 机器人 的身份出现。
- 当用户通过 Devin Review 编写评论或审查时,这些内容会显示为该用户的 GitHub 身份。
- 当用户让聊天智能体进行代码修改时,由此产生的提交会以 Devin 机器人 的身份创建。
- GitHub Suggested Changes 遵循 GitHub 的标准行为:任何审查者 (包括 Devin) 都可以在审查评论中留下建议修改。应用建议与启动自动修复会话是两个独立的操作。
- Devin 绝不会在用户未明确发起操作的情况下,代表用户创建提交或评论。
自动修复
自动修复会启动一个 Devin 会话,处理 PR 中的审查发现项。这与应用单条建议的修改不同,也不同于让 Review 聊天智能体准备 commit。如何启用
对于已归属于某个 Devin 会话的 PR,自动修复遵循 Automatically fix Devin Review findings 设置:“Devin will automatically triage the findings and decide whether to fix, validate, or escalate them to you.” (Devin 会自动对发现项进行问题分诊,并决定是修复、验证还是上报给你。) 该设置分为组织默认设置和个人选择两个层级:- 组织层级 — 组织管理员可在 Settings > Devin 的 Pull requests 下开启或关闭此设置。正如该行说明所述:“This option configures the default for all users.” (此选项用于配置所有用户的默认值。) 其他成员无法更改。在企业账户中,每个组织都有各自的默认设置。
- 个人层级 — 你可以在 Settings > Preferences 的 Devin sessions 下,为你自己的会话所创建的 PR 开启或关闭此设置。在你更改之前,开关显示的是组织默认设置。如果你的选择与默认值不同,会显示 Reset to organization default 标签,鼠标悬停时可查看说明;点击该标签,或将开关切回与组织一致的值,即可重新跟随组织设置。无论是开启还是关闭,你的个人选择始终优先,即使组织默认关闭,你也可以为自己开启。
如果 Automatically fix Devin Review findings 处于关闭状态,使用 Devin 自动修复
也会为你开启该设置。
Devin 自己创建的 PR 上的发现项
新发现项在逐条发布之前,会先交由创建该 PR 且符合条件的会话处理。在 GitHub 上:- PR 会显示 Devin is fixing (Devin 正在修复) 这些发现项,同时这些发现项会移至 缺陷 选项卡中的 Devin is fixing 下。
- 如果会话所有者开启了 Automatically fix Devin Review findings,且 PR 监控处于活跃状态,会话会尽可能修复问题,并为每个发现项记录处理决定。
- Devin 会发布一条审查,说明修复了哪些内容,详细信息列在 Fixed by Devin 下。留给你处理的发现项会按照你的发布设置以评审意见的形式发布。被 Devin 判定为无效的发现项不会发布。
权限与限制
- 更改 Automatically fix Devin Review findings 的组织默认设置需要组织管理员权限。在每位成员自己的会话中,其个人选择优先于默认设置。
- Settings > Devin > Pull requests 中的 Responding to bots 设置仍用于控制来自其他机器人的评论,但不再控制自动修复。
- Devin Review 的 No Issues Found 汇总评论始终会被忽略。只有包含实际问题的评论才会触发 自动修复。
如果 Devin Review 发布发现项时 Automatically fix Devin Review findings 处于关闭状态,你会在会话时间线上看到启用该设置的提示。
自动审查
如需审查你创建的 PR,请使用你的个人偏好设置。如需审查你团队的 PR,请在审查设置中添加一条规则。无论哪种方式,代码仓库都必须已连接到 Devin,即使是公开代码仓库也不例外。新账户默认带有一条账户级规则:Devin 会话创建的 PR 在准备就绪时以及每次 push 时都会被审查;同时
Automatically fix Devin Review findings 默认开启,因此这些会话会修复相应的发现项。你可以在审查设置中编辑或删除该规则。仅有单个组织的现有非 Enterprise
账户也已获得相同的规则和设置,除非管理员此前已关闭该设置或删除了该规则。在其他所有现有组织中,规则保持不变;且仅当
Responding to bots 已允许 Devin 响应 Devin Review 的评论时,该设置才会开启。
触发模式
选择规则的启动时机:- PR is created — 在 PR 打开时触发,包括以草稿形式打开。
- PR is ready — 在 PR 以就绪状态打开或被标记为就绪时触发。
- Only once — 满足触发条件时仅审查一次。
- Every push — 后续每次 push 时都会重新审查。此选项需要完整的自动审查用量层级。在使用代码仓库授予的权限时,只要某个授予你该代码仓库编辑权限的组织允许 Every push,代码仓库规则就会提供 Every push 选项,即使你是在另一个组织中查看设置也是如此。如需了解后续审查涵盖的内容,请参阅下次 push 时会发生什么?。
自助纳入 (所有用户)
当您的账户启用了个人纳入功能后,已关联 Git 托管服务提供商身份且具备相应 Review 使用级别的用户,无需管理员权限即可自行纳入。- 前往 Settings > Preferences。
- 在 Devin Review 下,将 Analysis trigger 设置为 Analyze PRs automatically when opened 或 Analyze PRs automatically when ready for review。
- 如果您的权限允许,将 Analysis frequency 设置为 Only once 或 Every push。
限定范围的规则与排除规则
审查管理员可在 设置 > 审查 的 Review 选项卡中配置自动审查规则。该页面还包含 安全、自定义审查者、Autoapprover 和 计费 选项卡;其中 安全 选项卡向账户审查管理员显示。 打开 Automatic analysis 下的添加菜单 (列表为空时为 Add repositories or users,之后为 Add repository) ,然后选择规则的适用范围:Add GitHub organization、Add GitLab group、Add Azure DevOps project、Add Bitbucket workspace 或 Add Bitbucket project 覆盖该命名空间下的所有代码仓库;Add single repository 仅覆盖单个代码仓库;Add user 覆盖某个账户成员创建的所有 PR;Add advanced rule 则用于组合多个条件。在规则对话框中,选择 Repository 或 Organization 作为目标,再通过条件进一步缩小范围:
is 和 is not 按文本精确比较;对于代码仓库、标题、分支和更改文件条件,可选择 matches 或 does not match 来使用 glob 模式匹配。随后选择规则的触发事件和执行频率。规则的 分析强度 可沿用账户默认值,也可用 Normal 或 Ultra 覆盖。
对于带有 Originated by Devin 条件的自动规则,该条件能否匹配取决于启动该 Devin 会话的用户所属的使用级别。若级别仅限创建时审查,则允许首次符合条件的审查,但后续推送不会触发审查;若级别仅限手动审查,或用户没有 Review 权限,则该条件不会匹配。
对于不希望该功能处理的 PR,请使用排除规则。命中的排除规则优先于该功能的纳入规则。
当排除规则导致某个 PR 跳过自动审查时,展开 Automatic analysis skipped by an exception 即可查看你有权查看的匹配规则。你仍可运行一次性审查;后续推送仍会被排除。
自动审查、每个 自定义审查者 以及 Autoapprover 的规则相互独立。启用普通自动审查不会同时启用 Autoapprover,也不会启用没有匹配规则的自定义审查者。Autoapprover 的排除规则也不会禁用普通自动审查。
规则取代了之前的代码仓库和个人纳入列表。旧版纳入条目已不再触发审查,请改为配置相应的规则。
在 Git provider interaction 下,账户审查管理员还可以关闭 Let Devin Review edit the PR description (默认开启) ,该选项会在 PR 描述中添加链接和审查状态。关闭后,你的描述将保持原样;在 GitHub 上,链接和状态会改为显示在一条 PR 评论中。
发布到 GitHub
账户的审查管理员可以在 设置 > 审查 中配置 Devin 回传到所连接 Git 托管服务提供商的内容。Post findings to 部分以你已连接的提供商命名,用于选择哪些发现项类型以评论形式发布:bug 和标记在 Review 选项卡中设置,安全发现项在 安全 选项卡中设置。Review 选项卡上的 Git provider interaction 部分则包含 CI 检查和 PR 描述链接的开关:- Post CI check — 启用时 (默认) ,Devin 会在受支持的提供商上为每次审查创建一个
Devin Reviewcommit 状态。Passing condition 用于设置判定通过的条件:审查完成 (默认) 、会话串均已解决,或没有发现项。在 Azure DevOps 上,该状态会同时发布到 commit 和 pull request 本身,因此会显示在 pull request 的状态列表中,并可通过 Status 分支策略 (genre 为devin,name 为Devin Review) 设为必需项。请将该策略的 Authorized identity 设置为 Devin 发布时所用的账户,以免其他身份也能满足该策略。 - Bugs — 将 bug (可能的错误或异常行为) 作为 PR 评论发布。
- 安全 — 将安全漏洞和安全加固建议作为 PR 评论发布。
- Flags (investigate) — 将 investigate 标记 (值得进一步仔细检查的潜在问题) 作为 PR 评论发布。
- Flags (note) — 将信息类标记 (可能无需采取行动的观察项) 作为 PR 评论发布。
企业账户: 设置会应用于企业中所有组织。更改账户级发布控制项需要账户级的 Manage
Review 权限;组织级规则管理权限不足以更改这些默认值。组织自身的 Review 设置页面仅适用于
该组织的代码仓库,并会锁定标有 Enterprise-level setting 的 enterprise-wide 设置;
如需更改,请前往企业的 Review 设置。
指令文件
Devin Review 会遵循代码仓库中的指令文件。如果这些文件中的任意一个存在,它们都会在分析你的 PR 时作为上下文使用:**/REVIEW.md**/AGENTS.md**/CLAUDE.md(不区分大小写)**/CONTRIBUTING.md(不区分大小写).cursorrules.windsurfrules.cursor/rules*.rules*.mdc.coderabbit.yaml/.coderabbit.ymlgreptile.json
.agents/、.devin/、agents/、.cursor/、.github/) 中的文件在确定作用域时会被视为属于其父目录。例如,src/.agents/REVIEW.md 适用于 src/ 下的文件。
这些文件为审查提供上下文。如果你需要一项能单独报告自身发现项的具名检查,请改为设置自定义审查者。
REVIEW.md
REVIEW.md 是专门为 Devin Review 准备的说明文档。将它放在代码仓库中的任意位置,即可自定义 Devin 在你的项目中审查 PR (拉取请求) 的方式。Devin 会在任意目录层级 (**/REVIEW.md) 自动查找 REVIEW.md 文件,因此如有需要,你可以将审查规范限定到特定子目录。
使用 REVIEW.md 来定义与代码审查相关的专项规范,例如:
- 代码库中需要额外严格审查的区域
- 需要留意的常见陷阱或反模式
- 审查者应当强制执行的项目特定约定
- 在审查期间可以安全忽略的文件或目录
- 你项目特有的安全或性能方面的注意事项
REVIEW.md:
自定义审查规则
你可以在 设置 > 审查 的 Context 下配置额外的文件,供审查时作为上下文读取。这些文件模式与自定义审查者相互独立:它们只提供背景信息,而不会定义一个生成自身发现项的审查者。 添加代码仓库文件的步骤如下:- 在审查设置的 Review 选项卡中找到 Context。
- 选择 Add context。此时会直接打开 Add repository files,或弹出一个菜单供你选择 Repository files。
- 输入文件 glob 模式 (例如
docs/architecture/**/*.md) 并添加。
审查上下文指示 (Beta)
书面审查上下文指示目前处于 Beta 阶段,需开通 Beta 访问权限才能使用。
代码仓库指令文件仍可单独使用,不受影响。
- 打开 设置 > 审查,找到 Context。
- 打开添加菜单,选择带有 Beta 标记的 Managed instructions。
- 输入标题和审查指导内容。
- 选择 All repositories,或选择范围更小的代码仓库作用域。
- 点击 Add context。
自定义审查者 (Beta)
自定义审查者目前处于 Beta 阶段。如果你无法创建或配置审查者,请联系你的组织或账户的 Review manager。
创建审查者
- 打开 设置 > 审查,然后选择 自定义审查者 选项卡。
- 选择 Add reviewer,然后输入 Name,并可选填写描述。
- 在 Instructions 下,选择 Plain text 并描述需要检查和需要忽略的内容;或者选择 仓库技能 或 Organization skill (在企业中为 Enterprise skill) ,以现有技能为依据进行审查。
- 选择 Finding urgency:Severe 用于必须修复的问题,Moderate 用于值得调查的标记,Info 用于建议和上下文信息。
- 选择 Create and enable,或选择 Save as draft 以便稍后完成。
- 打开该审查者并查看 Rules。如果你有权为整个账户管理审查,新审查者会默认开启 Run with Devin Review,因此会参与每一次审查。若要仅针对特定 PR,请关闭此选项并选择 Add reviewer rule。否则,审查者在创建时没有任何规则,你需要添加规则来指定它检查哪些 PR。
复用技能
基于 Repository skill、Organization skill 或 Enterprise skill 创建的审查者会默认勾选 Keep the reviewer in sync with the skill:此时其指示在审查者中为只读,并会随技能的更改自动更新。代码仓库技能从代码仓库的默认分支 (通常为main 或 master) 读取。
代码仓库技能来自智能体技能目录 (例如 .agents/skills/ 或 .devin/skills/) ,以及代码仓库中的任意 plugin:使用其 .devin-plugin/plugin.json 或 .claude-plugin/plugin.json 中 skills 所列的目录,未指定时默认使用其 skills/ 目录。
如果取消勾选该选项,审查者将保留当前文本,技能的更新需经你批准后才会应用。如需自行编辑指示,请选择 Change source… 并切换到 Plain text,这会解除审查者与其技能的关联,同时保留当前文本。
在企业中,审查者是共享的。来自某个组织技能的文本 (包括其后续修改)
仅该组织的成员可以读取;
其他 Review 管理员仍可编辑该审查者的其他设置。
发现项与 CI 检查
发现项会标注审查者的名称及其已配置的紧急程度。View runs 会显示每个审查者的运行历史,包括已修复和已忽略的发现项数量,并支持按发现项结果过滤运行实例。 每个审查者还有一个 CI check 部分。其中的 Post CI check 设置决定该审查者的发现项是计入 Devin Review 检查 (Part of Devin Review) ,还是作为以该审查者命名的 Separate check 单独发布,例如Devin Review / API compatibility。独立检查的 Passing condition 可以是:
- Reviewer finishes — 审查完成即视为通过,即使发现了问题。
- All comments are resolved — 该审查者发布的评论均已解决。
- There are no open findings — 该审查者的发现项均已关闭。
支出限额
每个审查者的 Spend limit 部分用于控制其在单个 PR 的自动审查中可支出的额度。Budget 提供两个选项:- Part of Devin Review limit (默认) — 该审查者的支出计入每个 PR 的自动审查支出限额。可选择设置 Limit per pull request,使该审查者的上限低于该限额。
- Separate budget — 该审查者从自己的 Limit per pull request (必填) 中支出,且在达到 Devin Review 限额后仍会继续运行。只有账户级别的 Review 管理员才能选择此选项。
版本历史与归档
在审查者页面上选择 Last updated on … 即可打开其版本历史。版本历史会列出指示的最近 20 个版本,并显示每个版本相对于上一版本的变更。Restore 会将较早版本的指示另存为一个新版本。如果审查者遵循某个技能,则须先停止遵循该技能,才能恢复较早的版本。 禁用审查者可停止其后续运行,同时保留其配置。归档会将审查者移至审查者列表下方的 Archived reviewers 中,并停止其运行;已发布的发现项会被保留。Restore 会将已归档的审查者恢复为已禁用状态,在你启用之前,它不会再次运行。Autoapprover (Beta)
Autoapprover 目前处于 Beta 阶段,需要开通 Beta 访问权限。
- 意图: 变更是否符合 PR 作者所述的意图?
- 代码质量: 变更能否让代码库保持可维护、易于审查?
- 事件风险: 变更中的问题是否可能引发可靠性或安全事件?
设置 Autoapprover
- 打开 设置 > 审查,然后选择 Autoapprover 选项卡。如果该选项卡提示您的账户暂不可用 Autoapprover,说明您的账户尚未获得 Beta 访问权限。
- 添加一条 Autoapprover 规则,选择需要评估的代码仓库和 PR 条件。
- (可选) 为不希望其评估的 PR 添加 Autoapprover 排除规则。
可选的自定义指示
如需调整默认评估标准,请在 Instructions 下选择 Add instructions,并选择这些指示的适用范围。请说明您的团队可以接受自动批准哪些内容,以及哪些内容始终需要人工处理。在这些指示所涉及的标准上,其优先级高于默认评估标准;如果指示之间相互冲突,则以作用域更窄的指示为准。Autoapprover 会跳过无法验证的指示 (例如依赖 CI 状态的指示) ,并在结论中说明跳过了哪些内容。 Autoapprover 在依据评估标准评估 PR 时,还会读取代码仓库根目录、已更改文件所在目录及其父目录中的APPROVAL_POLICY.md 文件以及 AUTOAPPROVE.md 文件 (旧名称) 。Autoapprover 从 PR 的目标分支读取这些文件,因此 PR 无法自行编写其批准规则;文件内容会作为指示提供给审查者。更改了 APPROVAL_POLICY.md 或 AUTOAPPROVE.md 文件的 PR 始终需要人工审核。
指示仅用于指导决策,本身不会将 PR 纳入自动批准范围。例如,在添加一条仅限于某个文档代码仓库的规则后,你还可以选择添加:
.github/ 下的更改或超过大小限制的差异) ,请使用 Autoapprover 排除规则。请继续保留分支保护和访问控制项。
理解结果
PR 中的 Autoapprover 部分会显示评估结果及理由:- Autoapproved — Devin 已批准该 PR。
- Not autoapproved — 该 PR 需要人工审核。
- Approved by a person — 已有人工给出批准。
权限与成本
权限
Devin Review 的访问权限由角色编辑器中的 Devin Review 权限控制。不同使用级别分别对应手动审查、在创建 PR 时审查以及完全自动审查。账户级配置需要 Manage Review 权限 (在部分角色编辑器中显示为 Manage Devin Review) ;不过如下文所述,对于代码仓库授权所覆盖的规则,仅有该授权可能就已足够。 企业管理员可以通过自定义角色限制用量或授予配置权限。账户级权限管控账户级配置;组织级 Review 权限管控企业内各组织的访问。如果使用代码仓库授权,那么为某个代码仓库或 Git 连接配置 Review 的授权,也能让你访问设置 > 审查,管理该授权所覆盖的规则。 启用自助注册后,自助注册无需 Manage Review 权限,但可用的触发模式受你的使用级别限制。 如需了解 Devin Review 权限层级的完整列表及各层级授予的权限,请参阅账户级角色。 管理组织的自动审查规则和排除规则需要 Manage analysis rules 组织权限。内置的 Review manager 组织角色在成员权限的基础上额外授予该权限。企业账户: 组织的 Review manager 无需成为主组织管理员,即可配置其获准的
作用域。账户级控制项 (例如发布默认值和审查上下文指示) 仍需要账户级
Manage Review 权限。企业策略可以禁止组织级编辑。
成本控制
Devin Review 会消耗你所在企业 ACU 池中的 ACUs (Agent Compute Units) 。该资源池也用于 Devin 会话和其他 Devin 产品。企业管理员可使用多种工具来监控和控制审查成本。企业组织和用量控制项需要 Devin
Enterprise 账户。按 PR 设置的自动审查支出限额同样适用于
基于配额的套餐。如需企业套餐,请联系销售。
用量仪表板
设置 > 用量中的企业用量仪表板会按产品细分 ACU 用量,其中每日用量图表中单独列出了一条 审查 线。组织管理员可以在设置 > 用量分析中查看其组织的审查资源消耗。 该仪表板包括:- 按用户细分 — 查看每位用户在当前和上一计费周期消耗了多少审查 ACU。
- 按代码仓库细分 — 查看当前和上一计费周期内各代码仓库的审查 ACU 用量、审查次数以及发现的 bug 数量,帮助识别哪些代码仓库产生了最高的审查成本,以及审查在哪些代码仓库中发现了最多问题。
审查规模指示器
Devin Review 中的每个 PR 都会显示一个用量标签,根据该 PR 上所有审查作业的 ACU 总用量,展示该次审查对应的 T 恤尺码分级:
将鼠标悬停在该大小标签上,可查看精确的 ACU 总量、已运行的审查作业数,以及当前查看的这次审查成本。这有助于审查者了解重新运行审查,或在频繁变更的 PR 上启用自动审查所带来的成本影响。
单个 PR 的自动审查支出上限
Admin 可以在 设置 > 审查 的 计费 选项卡中,于 Automatic analysis limits 下,为 Devin Review 在单个 PR 上的自动审查支出设置上限。在按 ACU 计费的套餐中,该上限以 ACU 计量;在基于配额的套餐中,则以按需支出的美元金额计量。将该字段留空时,将使用设置中显示的、由 Cognition 管理的默认值;这并不表示不设上限。 一旦某个 PR 在所有审查作业中的总审查支出达到该上限,该 PR 的自动审查就会被关闭,之后的自动审查也会被跳过。达到上限属于软性限制:- 手动审查仍可使用 — 该上限只会暂停自动审查。你始终可以在 PR 审查页面自行触发审查。
- 按 PR 重新启用 — 在该 PR 的操作菜单中重新打开自动审查后,审查会恢复,并会追加一份预算额度。已记录的支出不会被重置;新的预算用尽后,自动审查可能会再次暂停。
审查强度与计费组织
账户的 Review manager 可在审查设置的 分析强度 中选择默认的 Normal 或 Ultra 强度。Normal 侧重性价比;Ultra 审查更为全面,但成本更高。 企业账户还可在 计费 选项卡中配置 自动分析的默认计费组织 设置,用于无法通过其他方式解析计费组织的审查。该设置需要账户设置权限。启用组织署名后,审查资源消耗视图可显示最近一次审查计费到了哪个组织 (或账户本身) 。 如果 计费 选项卡中提供了 代码仓库计费规则,组织的 Review manager 可以编辑交由其管理的代码仓库的规则,并将审查费用计入其所管理且符合条件的组织或预算。但如果某条规则已将费用计入其不管理的付款方,他们则无法更改该规则。支持的 Git 托管服务提供商
dev.azure.com) 以及 Azure DevOps Server 2020/2022。可通过 Azure DevOps 集成、Microsoft Entra service principal,或使用个人访问令牌连接 Azure DevOps Server collection,然后在 设置 > 审查 中登记仓库以启用自动审查。Devin 会通过已连接的服务身份发布自动发现项。如需以你本人的身份评论、回复、解决会话串、对 PR 投票或放弃 PR,请将你的个人 Azure DevOps 账户关联到 Devin。以用户身份执行的操作需要受支持的 Microsoft 委托身份,而共享的服务器 PAT 无法提供此类身份。聊天中的编辑可作为单个 commit 应用,已关联的账户可以在 Review 中查看其 PR 列表。不支持合并、草稿操作和自动合并。
Bitbucket Data Center 需要 8.16 或更高版本,并通过 Bitbucket 集成 连接。如需在 Devin Review 中评论、添加或移除审查者、批准或拒绝 PR,请关联你的 Bitbucket 账户。不支持合并、标签、经办人和表情回应,且通过聊天生成的代码修改会逐个文件提交。
Bitbucket Cloud (bitbucket.org) 通过 Bitbucket 集成 提供支持。使用对相关仓库具有管理权限的访问令牌或通过 OAuth 关联的专用 Devin 账户连接你的 workspace (Devin 会自行安装自动审查所需的 webhook) ,然后在 设置 > 审查 中添加自动审查规则。在 Devin Review 中发表评论、回复或拒绝 PR 时,均会使用你自己的 Bitbucket 账户以你的身份发布。不支持请求审查者、合并、草稿操作、自动合并、标签、经办人和表情回应。通过聊天生成的代码修改会以单个 commit 提交。
Perforce Swarm 支持通过连接的服务身份进行审查分析并发布自动发现项。对于此提供商,Devin Review 用户界面中的人工评论和批准操作均为只读,且无法将聊天中的编辑作为 commit 应用。Swarm 审查不会出现在个人 PR 收件箱中。Perforce 连接目前仅向部分账户开放。
