结论先说
- 永远把「写代码」和「拆提交」分成两个明确阶段。让 Codex 完成需求后,先别让它顺手执行
git add . && git commit,而是先看git diff --stat,把改动按「结构准备 / 核心功能 / 测试用例 / 文档配置」分组拆成 2 到 4 个独立可验证的原子小提交。 - 生成 Conventional Commits 时,只喂
git diff --cached(已暂存区)。让模型严格只基于当前暂存的真实差异写<type>(<scope>): <subject>,能彻底杜绝「提交说明里吹牛写了没改的功能」或漏报破坏性变更。 - 整理 PR 描述要围绕「审阅者省时间」来组织(本站建议)。基于
git log main..HEAD与git diff --stat main...HEAD自动生成包含「背景动机、核心变更清单、本地验证命令、潜在影响与回滚方式」的结构化草稿,推远端前再跑一次 Codex/review自查。 - 把团队 Git 纪律固化进仓库
AGENTS.md。明确约定禁止直接向main提交、禁止在功能提交里夹带全文件重排,以及强制使用英文或中文 Conventional Commits 格式,团队协作效率能瞬间拉齐。 - 从需求拆解、拆小提交到多轮
/review自查,高频使用 Codex 的研发流程非常依赖稳定配额。个人开发者可在本站按需开通 ChatGPT Plus 或更高配额的 ChatGPT Pro,团队统一采购可了解 ChatGPT Business 团队定制。

图:本站根据 Conventional Commits 规范 与 Codex 团队协作实践整理的示意图
本文根据 Conventional Commits 1.0.0 规范、GitHub Pull Requests 官方文档与 OpenAI Codex CLI 协作实践整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 用 Codex 快速写完一个跨 15 个文件的功能,却发现
git status一团乱麻、不知道怎么拆成清晰提交再提 PR 的开发者; - 团队要求严格遵守 Conventional Commits 规范、CI 卡提交信息校验,希望自动化生成高质量 Commit Message 与 PR 说明的工程师;
- 经常被同事吐槽「AI 改的 PR 太大没法审阅」,想建立标准化 Git 协作纪律的小组负责人。
一、先定规矩:用 Conventional Commits 划分提交边界
很多时候提交乱成一锅粥,是因为开工前就没对齐提交粒度。Conventional Commits 1.0.0 的标准格式非常简洁:<type>(<optional scope>): <description>,常见分类与拆包原则如下:

图:本站根据 Conventional Commits 1.0.0 规范 整理的示意图
把下面这段短规约放进项目根目录的 AGENTS.md(加载原理见 /guides/codex-agents-md-how-it-reads),Codex 就能在每次收尾时自觉按规矩出牌:
markdown
## Git 提交与 PR 协作约定
- 新任务必须在独立功能分支(如 `feat/...`、`fix/...`)进行,禁止直接向 `main` 提交。
- 遵循 Conventional Commits(feat/fix/refactor/test/docs/chore/ci),标题控制在 72 字符内,用祈使语气说清“改了什么”。
- 拆分原子提交:纯重构、业务逻辑、测试补充与文档调整应尽量分开暂存提交,严禁在业务 PR 中顺手全局格式化无关文件。
二、实战 1:让 Codex 帮你把大改动安全拆成小提交
假设你刚让 Codex 完成了「订单超时重试 + 提取公共工具函数 + 补单元测试 + 更新 README」,此时工作区挂着 12 个修改文件。不要直接 git add .,直接给 Codex 下达拆分指令:
text
请先执行 git status 与 git diff --stat,不要做任何提交。
把当前未暂存改动按「独立可审查、独立可回滚」原则规划为 3 到 4 个原子提交,给出每个提交应包含的文件路径列表和建议的 Conventional Commits 标题;等我确认后再分批执行 git add 与 commit。
拿到清单核对无误后,再逐批暂存并验证:
- 同一文件混了两种改动怎么办? 不要勉强用普通
git add <file>整文件塞进去,建议由开发者自己执行git add -p <file>按代码块(hunk)手动挑选暂存,把「重构清理」和「核心修复」切干净。 - 每拆出一个小提交,顺手跑一下快速测试或类型检查,确保历史记录里的每一个中间提交都是可编译的,方便日后
git bisect排错。如果不小心拆乱了或暂存错位,可按 /guides/codex-undo-bad-changes-rewind-git-diff-rollback-guide 里的步骤无损撤回重来。
三、实战 2:基于 git diff --cached 自动生成精准 Commit Message
为了防止模型受长聊天上下文里「早就否决掉的方案」干扰而写歪提交说明,本站建议用非交互管道 codex exec 只喂给它当前暂存区的真实 Diff:
bash
git diff --cached | codex exec "严格仅根据输入的 git diff 生成一条符合 Conventional Commits 1.0.0 的提交信息:第 1 行为 <type>(<scope>): <简明主题>(不超过 72 字符),空一行后用 2-3 条短列表说明核心变更与影响。不要编造 diff 中未出现的内容,只输出提交文本本身。"
看完输出的草稿没问题,复制或通过 git commit -F - 落盘提交即可。更多利用管道结合 codex exec 的提效技巧,可参考 /guides/codex-cli-pipe-stdin-exec-recipes。
协作与订阅提示:如果团队习惯把「拆提交 + 写 PR 描述 + 全分支深度审查」全部纳入日常研发流,持续调用高推理模型很容易消耗大量短周期额度。重度开发者可在本站升级 ChatGPT Pro 充值 或 ChatGPT Pro 5x 档位;若新同事注册账号卡在手机校验环节,也可查看 Codex 注册手机验证服务。
四、实战 3:推 PR 前跑 /review 自查并一键整理 PR 描述
全部小提交整理完毕后,在推送远端和点开 GitHub 创建 Pull Request 前,按这两步收尾(本站建议):
第 1 步:用内置 /review 先审一遍整条分支
在 Codex CLI 交互界面中,直接调用 /review 指定对照主分支(例如 main),重点让它排查未清理的调试日志、缺失的边界判断、遗漏的测试断言与锁文件误改。具体对照基线与自定义聚焦维度玩法,详见 /guides/codex-review-base-uncommitted-custom-focus-guide 与 /guides/codex-code-review。
第 2 步:汇总提交历史与统计差异生成 PR 描述
将本分支相对于 main 的提交列表和文件统计一次性交给 codex exec 生成 PR 正文草稿(如果本机安装了 GitHub CLI gh,可直接填入 gh pr create --draft):
bash
(
echo "=== COMMITS ==="
git log main..HEAD --oneline
echo "=== DIFF STAT ==="
git diff --stat main...HEAD
) | codex exec "根据以上分支提交记录与变更统计,用中文生成一份清晰的 GitHub PR 描述,固定包含 4 个小节:1) 背景与动机;2) 核心变更清单;3) 本地验证命令与结果(若输入未提供结果则留待补填占位);4) 影响范围与回滚方案。严禁虚构未提供的测试结果。"
最后再由本人补上真实跑过的单测结果或页面截图,一份让同事五分钟就能审完的规范 PR 就准备妥当了。
常见问题
问:可以让 Codex 自动执行 git push --force 或自动合并 PR 吗?
答:强烈不建议(本站建议)。让 Codex 负责拆分规划、生成规范文案和本地自查即可;涉及推送远端、强推历史、合并受保护分支或删除远端分支的动作,务必保留在人工确认环节,防止自动化误覆盖同事提交。
问:团队规范要求提交标题写中文,或者必须附带 Jira / Linear 需求单号,怎么改?
答:只需要在仓库 AGENTS.md 里给出 2 条正反示例(例如 feat(order): 支持订单超时自动取消 (#PROJ-128)),并在生成指令里加上「必须包含需求单号且保留英文 type/scope」,Codex 就能稳定按统一模板输出。
问:国内没有外币信用卡,或者研发团队想统一采购 ChatGPT Plus / Pro / Business 来跑 Codex 协作流怎么办理?
答:可前往本站 AI 会员充值总览 按需选购 ChatGPT Plus 充值(含 Plus iOS 可覆盖版)或高配额 ChatGPT Pro 20x 档位,多人团队亦可选择企业定制方案。支持支付宝、微信支付与 AlipayHK,提供自助卡密兑换与增值税发票服务,具体以商品页实时展示为准;售后遵循掉订阅按剩余天数折退、封号不在质保范围内的规则。
相关教程
- Codex /review 按基线分支、未提交改动与自定义焦点自查指南
- Codex Code Review 代码审查完整用法
- Codex CLI 管道输入与 codex exec 实战配方
- Codex 如何读取与合并 AGENTS.md 指令文件
- Codex 改坏代码怎么安全撤回、回滚与核对 Git Diff
参考资料
- Conventional Commits 1.0.0 官方规范 — https://www.conventionalcommits.org/en/v1.0.0/
- GitHub 官方文档:Pull Requests — https://docs.github.com/en/pull-requests
- OpenAI Codex 官方开发者文档 — https://developers.openai.com/codex
- OpenAI Codex 官方 GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~