审查你的第一个 Pull request

你将构建什么

读完本教程，你将拥有：

在 Control Center 的 PR 工作台中打开了一个 pull request
阅读了它的差异，并留下了一条行内评论
提交了一次审查判定
合并了该 PR

前置条件：已完成派发你的第一个智能体，并且本工作区中注册的某个仓库上有一个打开的 pull request。审查相关的步骤请选择一个不是你打开的 PR——评审按钮在你自己发起的 PR 上会被隐藏。合并操作在你发起的 PR 上仍然可用。

第 1 步：打开 pull request

点击侧边栏中的 Pull requests
找到你的 PR 并点击它

**检查点。**该 PR 会以标签式工作台的形式打开——概览、Diff、源代码管理、聊天、操作——并聚焦在概览上：标题与操作、描述与活动时间线，以及一个侧栏，其中有状态、审查者、受理人、检查和变更文件。点击那里的某个文件会跳到 Diff 标签页中的对应位置。在有人请求 AI 审查之前，PR 审查 标签页不会打开。

第 2 步：阅读差异

打开 Diff 标签页。左侧是可折叠的文件树，差异上方的条带中有一个提交范围选择器——可把差异缩小到单个提交或一段提交——以及文件数量和实时的新增与删除行数。

差异工具栏中的设置按钮控制它的渲染方式：

分栏或统一视图
自动换行或滚动长行
代码字体连字

在大差异中把文件标记为已查看，可以跟踪你的进度。键盘导航见键盘快捷键。

第 3 步：留下行内评论

将鼠标悬停在差异中的某一行上——行号栏中会出现一个小小的 + 胶囊按钮
点击它即可对该行发表评论，或先垂直拖动它来选择一段范围
输入你的反馈。撰写框提供两种提交方式：
- 开始审查（如果已有审查正在进行，则为 添加到审查）会把评论加入队列。在你于第 4 步提交判定之前，讨论串会显示 待提交的审查。
- 添加单条评论会立即把它发布到 GitHub。讨论串会显示 正在发布…，然后是 已同步；如果发布失败，会提供重试。

本教程请使用 开始审查，这样评论会随判定一起发出。

第 4 步：提交审查

点击概览操作行中的评审——同一个按钮也位于 Diff 标签页的工具栏中。在你发起的 PR 上，以及已关闭或已合并的 PR 上，它都会被隐藏。
在撰写框中写一段摘要。它会自动保存为草稿，因此你可以关闭这个浮层稍后再回来。
选择一个判定：
- 请求变更
- 评论
- 批准

判定_就是_这个按钮。按下批准或 请求变更 后，按钮会改名为 已批准 或 已请求变更。评论判定则让按钮保持评审。

**检查点。**如果你选择了这两者之一，按钮会显示“已批准”或“已请求变更”。

第 5 步：合并

只要 GitHub 报告该 PR 可合并，合并按钮就会出现——它并不以你自己的批准为前提。它的颜色表示的是就绪程度而非权限：必需的批准和检查都为绿色时为主色，检查仍在运行时为次色，被请求的审查者尚未批准或某个检查未通过时为危险色。

点击合并
选择一种方式：压缩并合并、创建合并提交 或 变基并合并
对于前两种，编辑已预填的提交标题和说明
确认

任何尚未解决的问题——“检查未通过”、“部分审阅待完成”——都会在你确认前列在浮出面板中。

合并后，PrMerged 领域事件会触发；分析和通知会消费它。其他监听者见领域事件。

用 AI 审查

Control Center 可以把审查者流水线放到一个打开的 PR 上，但只有在你主动请求时才行：pr_review 模板只有手动触发器，没有别的触发方式。

打开概览操作行中的溢出菜单，选择 询问 AI。Control Center 会启动该运行并打开 PR 审查 标签页，这样你就能看到各位专家的工作过程。
审查者智能体会把它们的发现项记录为该 PR 空间中的审查节点；最后一个步骤会把它们汇总成一份报告。

该流水线刻意不发布到 GitHub——它在汇总之后就结束了。发布是你自己单独执行的一步，使用 PR 审查 标签页上的 发布到 GitHub 按钮。见使用 AI 审查。

回顾

你在工作台中打开了一个 PR，阅读了带语法高亮的差异，留下了一条行内评论，提交了判定并完成合并——全程没有离开应用。

下一步：构建你的第一条流水线，把多步骤工作流自动化。