在 App 中审查改动

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
Review pane	审查面板	App 里查看改动的界面。
Inline comments	行内评论	在具体代码行上给反馈。
PR review	PR 审查	在 App 里审查 Pull Request。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你在 App 里高效审查改动（看 diff、行内评论、PR 审查）。

你是 Codex App 改动审查顾问，帮我在 App 里高效审查 Codex 的改动并给出有效反馈。

【角色】
你熟悉 App 显示哪些改动、怎么用审查面板、行内评论给反馈、看代码审查结果、PR 审查。

【输入】
- 我要审查的改动规模：___
- 关注点（正确性 / 风格 / 安全 / 测试）：___
- 是单次改动还是 PR：___
- 我的审查经验：___

【工作流程】
1. 用 review pane 浏览改动
2. 在关键处加行内评论提反馈
3. 让 Codex 据评论修，再复审
4. PR 场景走 PR review 流程

【输出规范】
▌一、审查浏览方式
▌二、行内评论的写法
▌三、据反馈修 + 复审闭环
▌四、PR 审查流程

【硬约束】
- 改动逐项看，不囫囵接受
- 评论具体到行、说清期望
- 关键决策由人定，Codex 是辅助
- 高风险改动重点审
- 不确定的功能标注需查官方文档

Review pane 帮你理解 Codex 改了什么、给出针对性反馈，并决定哪些改动要保留。

它只适用于位于 Git repository 内的 projects。如果你的 project 还不是 Git repository，review pane 会提示你创建一个。

What changes it shows

Review pane 反映的是整个 Git repository 的状态，而不只是 Codex 编辑过的内容。

它会显示：

Codex 做出的 changes。
你自己做出的 changes。
repo 中其他 uncommitted changes。

默认情况下，review pane 聚焦 uncommitted changes。你也可以切换 scope：

Scope	说明
All branch changes	和 base branch 做 diff。
Last turn changes	只看最近一个 assistant turn 的改动。

本地工作时，还可以在 Unstaged 和 Staged changes 之间切换。

Navigating the review pane

常用操作：

点击 file name，通常会在你选择的 editor 中打开该文件。默认 editor 可以在 settings 中选择。
点击 file name background，可以展开或折叠 diff。
按住 Cmd 点击某一行，会在你选择的 editor 中打开对应行。
如果满意某个 change，可以 stage changes 或 revert 不想保留的 changes。

Inline comments for feedback

Inline comments 可以把 feedback 直接附到 diff 的具体行上。这通常是引导 Codex 进行正确修改的最快方式。

留下 inline comment 的步骤：

打开 review pane。
hover 你想 comment 的 line。
点击出现的 + button。
写下 feedback 并提交。
留完 feedback 后，回到 thread 发一条消息。

因为 comments 和具体行绑定，Codex 通常能比泛泛的 instruction 更精确地响应。

Codex 会把 inline comments 当作 review guidance。留下 comments 后，再发送一条明确意图的 follow-up message，例如：

Address the inline comments and keep the scope minimal.

Code review results

如果你用 /review 运行 code review，comments 会直接 inline 出现在 review pane 中。

官方截图：

Pull request reviews

当 Codex 拥有当前 repository 的 GitHub access，并且当前 project 位于 pull request branch 上，Codex App 可以帮你在不离开 App 的情况下处理 pull request feedback。

sidebar 会显示 pull request context 和 reviewers 的 feedback。review pane 会把 comments 和 diff 放在一起，这样你可以在同一个 thread 中要求 Codex 处理问题。

安装 GitHub CLI gh，并用下面的命令完成认证：

gh auth login

这样 Codex 才能加载 pull request context、review comments 和 changed files。如果缺少 gh 或没有认证，pull request details 可能不会出现在 sidebar 或 review pane 中。

适合把完整修复循环留在一个地方时使用这个流程：

在 pull request branch 上打开 review pane。
Review pull request context、comments 和 changed files。
要求 Codex 修复你指定的 comments。
在 review pane 中检查生成的 diff。
准备好后，stage、commit，并 push changes 到 PR branch。

GitHub-triggered reviews 见：

https://developers.openai.com/codex/integrations/github

Staging and reverting files

Review pane 包含 Git actions，方便你在 commit 前整理 diff。

你可以在这些层级 stage、unstage 或 revert changes：

层级	说明
Entire diff	使用 review header 中的 action buttons，例如 "Stage all" 或 "Revert all"。
Per file	对单个 file stage、unstage 或 revert。
Per hunk	对单个 hunk stage、unstage 或 revert。

当你想接受部分工作时，使用 staging。当你想丢弃某些改动时，使用 revert。

staged 和 unstaged 状态

Git 允许同一个文件同时存在 staged 和 unstaged changes。出现这种情况时，pane 可能看起来像是在 staged 和 unstaged views 中把“同一个文件显示了两次”。这是正常 Git behavior。