更快审查 Pull Request
本页根据 OpenAI 官方
Codex use cases页面重新整理，核对时间为2026-03-30。这里保留原文的任务边界、推荐技能和工作流重点，但改写成更适合课程、工作坊和机构授课的中文版本。
官方原始定位
- 官方标题：
更快审查 Pull Request - 官方难度：
Easy - 官方预估时长：
5s - 官方核心说明：在人工合并前，让 Codex 先给出一轮额外的代码审查信号，重点发现回归、缺失测试和行为风险。
这节课最适合哪些人
- 希望在人工 reviewer 之前先有一层自动预审信号的团队
- 生产环境代码库，改动影响面大、回归成本高的项目
- 讲师想把“代码评审”教成固定动作，而不是凭经验随缘检查的课程
课上应该带学员理解什么
- Codex 在这里不是“替你批准 PR”，而是先帮你缩短第一轮筛查时间
- 优秀的 review 提示词应该只看当前 diff，不要让模型不受控地漫游全仓
- 如果 Codex 已经指出问题，下一步可以继续用
@codex fix it或者本地任务把问题修掉
官方强调的工作流
- 先在 GitHub 组织或仓库里接入 Codex review，再决定是每个 PR 自动跑，还是通过评论触发
- 在 PR 评论中使用
@codex review发起一次针对当前改动的评审 - 如果发现问题，再用后续评论要求 Codex 针对具体问题修复
- 用顶层或更深层的
AGENTS.md定义 review 规则，让不同目录拥有不同检查重点
课堂演示顺序
- 先给学员看一个小 PR，让他们手工列出最担心的 3 类风险
- 再让 Codex 只看当前 diff，输出按严重级别排序的问题列表
- 挑一个问题继续追问：如何复现、为什么危险、需要补什么测试
- 最后对比人工和 Codex 的审查结果，讨论哪些是 AI 擅长先筛，哪些必须人来拍板
推荐技能与插件
- GitHub 集成：把 review 直接挂到 PR 上，而不是脱离上下文单独分析
- Security Best Practices：把注意力集中到密钥、认证、依赖变更等高风险区域
- AGENTS.md：用分层规则告诉 Codex 什么是你团队眼里的 P0、P1 和必须补充的问题
课堂版起手提示词
text
请只审查当前 diff，不要重写整个功能。
重点检查：
1. 行为回归
2. 错误处理或异常路径是否缺失
3. 边界条件、空状态和失败状态
4. 是否缺少关键测试
5. 是否存在高风险但不容易被注意到的行为变化
请先按严重级别列问题，再给出建议验证步骤。课堂验收与交付物
- 一份按严重级别排序的问题清单
- 一份建议补测的测试点列表
- 一段可以直接贴回 PR 评论区的总结
讲师讲这节课时最容易踩的坑
- 这节课最重要的不是让学员背命令，而是建立“先预审、再决定是否修改”的节奏
- 如果课堂里要演示自动 review，尽量选一个真实但改动范围可控的 PR
- 把
AGENTS.md的 review 规则一起讲，会让学员更理解团队规范如何落到工具上