14 · Git 工作流

📚 系列导航：上一篇 13 Memory 让 Codex 跨会话记住你。这一篇回到日常——让 Codex 当你 git 操作的副手。

---

01 先划线

操作类型	典型命令	交给 Codex？
只读查看	git status / git diff / git log	✅ 放心
本地修改	git add / git commit / 解冲突	✅ 它干完你过目
推到远端	git push	⚠️ 你来按
改写历史	git push --force	❌ 自己来

WARNING

在 AGENTS.md 里写「不要 push」不算数，得用 denylist 拦死。

---

02 本地操作

看 diff

看一下我现在暂存区的改动，用中文总结主要改了哪几件事，有没有看着不对劲的地方

写 commit message

帮我把暂存区的改动提交了，commit message 用中文，参照项目里以前的提交风格

TIP

把规范写进 AGENTS.md，它每次自动遵守。

解冲突

三步：先解释→你确认→执行并跑测试

第一步：

git merge 时这几个文件冲突了，帮我逐个分析两边改动分别想干嘛，给出合并方案，但先别直接改

第二步确认，第三步：

跑一遍测试确认没有引入新问题

检查点——最该养成的习惯

git add -A && git commit -m "让 Codex 改文件前的存档"

改炸了一行退回：git restore .

---

03 GitHub 审查：@codex review

这是 Codex 在 GitHub 上的核心功能——在 PR 里触发审查。

在 PR 评论框敲：

@codex review

Codex 会怎么做：

1. 先给评论加个 👀 反应，表示收到开始看
2. 在云端读这个 PR 的 diff
3. 像队友一样发一条 code review，只标 P0 和 P1 级别的问题（高优先级风险），不拿 nit 刷屏

NOTE

@codex review 只标记 P0/P1。那些「变量名好不好」「多个空格」的 nit，它默认不报。这是刻意的克制——让每条评论都值得看。

自动审查

在 Codex 设置里打开 Automatic reviews，新 PR 一开它就自动 review，不用每次手动 @。

定制审查规则

在 AGENTS.md 写 ## Review guidelines 小节：

## Review guidelines
- Don't log PII.
- Verify that authentication middleware wraps every route.

就近原则： 把更具体的规则放在子目录的 AGENTS.md 里。比如 src/payment/AGENTS.md 专门写支付相关的审查标准，Codex 审查该目录文件时会自动套用。

审查后修复

@codex fix the P1 issue

它会启动一个云任务，改代码并推回 PR 分支——前提是你授权了写权限。@codex review 走审查线，@codex + 其他内容走通用云任务线。

---

04 本地自查：/review

开 PR 之前先在终端自查一遍。

/review

四种预设：

• Review against a base branch（对基线分支）：开 PR 前先扫最大风险
• Review uncommitted changes（未提交改动）：提交前解决
• Review a commit（某个提交）：读指定 commit
• Custom review instructions（自定义指令）：自己写审查重点

纯本地只读，不连 GitHub，不改代码。

TIP

可在 config.toml 配 review_model 指定更强模型——日常会话用快模型，review 这种抠细节的活绑一个更强的。

---

05 开 PR

先装 gh CLI：brew install gh && gh auth login

帮我的改动开一个 PR，标题和描述用中文

---

06 焊死红线

# ~/.codex/config.toml
[sandbox]
denylist = [
    "git push *",
    "git push --force *"
]

WARNING

denylist 是软约束——拦得住 Codex 直接调工具，但拦不住脚本绕道。真要锁死，叠沙箱 read-only 模式。

---

07 小结

操作	交给 Codex？	关键点
看 diff	✅ 放心	零风险，让它划重点
写 commit	✅ 放心	照项目风格写，你过目
开 PR	✅ 先装 gh	自动提取 diff 上下文
解冲突	✅ 先讲再改	解释→确认→执行→跑测试
本地自查	✅ /review	只读不写，四种预设
GitHub 审查	✅ @codex review	只标 P0/P1
push	❌ 自己来	denylist 焊死

NOTE

下一篇：15 入门实战：30 分钟单会话：把前面学的东西串起来，30 分钟从零跑通一个最小项目。