提交信息看着是小事,积累久了就是项目的历史档案。写得含糊,三个月后回来看全是一堆更新、修改,根本不知道当时为什么改。Codex 能读 diff 自动生成提交信息,省去你憋措辞的时间,前提是你得告诉它按什么格式、写到什么程度。
这篇讲怎么让它写出有用的提交信息:先让它读改动、再定格式和粒度、区分类型和原因、避开把多个无关改动塞进一条的坑。

一、让它先读 diff 再动笔
把暂存的改动指给它看,让它基于真实 diff 写,而不是凭你一句概述猜。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
要求它先复述改了什么,确认理解一致再生成措辞。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
改动没暂存全时先补全,否则它会漏掉一部分内容。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
二、定好格式再让它写
团队用什么提交规范就照着来,把格式要求写成固定模板给它。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
一句话说清主题,正文补充原因和影响,别把所有信息挤在标题里。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
标题控制在一行能读完的长度,细节放到正文。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
三、写做了什么更要写为什么
只写改了哪个函数意义不大,补上为什么改,日后回溯才有价值。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
如果是为了修某个问题,把问题现象或编号带上。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
涉及行为变化的,说明对用户或调用方的影响。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
四、区分改动类型
新增、修复、重构、文档这几类分开标,扫历史时一眼能分类。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
混合了多种类型的提交最好拆开,别让一条信息背锅所有改动。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
破坏性变更要显著标注,避免别人升级时踩坑。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
五、一次提交只讲一件事
如果发现 diff 里混着两个不相关需求,先拆成两次提交再分别生成信息。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
改动太杂时让它按主题分组,你确认后再落地。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
小步提交比攒一大坨更容易写清楚,也更容易回滚。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
六、让它帮你发现问题
生成信息时顺手让它指出这次改动里可能的风险点。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
如果它说不清这次改动的意图,往往说明改动本身太杂,值得重新拆。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
把它标记的疑问当成自查清单,确认无误再提交。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
七、中英文与语气一致
团队统一用一种语言,别一条中文一条英文混着来。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
信息用陈述句,别写成口语化的我改了一下。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
术语保持和代码、文档一致,方便日后搜索。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
八、把偏好固化下来
把提交格式和语气要求写进规则文件,让它每次自动遵循。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
收集几条你认可的提交信息当范例,让它照着学风格。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
定期回看历史,看看信息是否真能帮上忙,不好就调整模板。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
九、别让它代替你思考
提交信息是给未来的自己看的,生成完要读一遍确认准确。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
涉及重要决策的背景,机器写不出来,得你自己补。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
别在没看懂 diff 的情况下直接提交,信息再漂亮也掩盖不了问题。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
十、常见错误
别让它夸大改动,写成重大升级而实际只是改个参数。这套做法适合放进日常流程里长期用,尤其是每周都会重复出现的 提交信息 类任务,形成习惯之后省下的是整块的重复劳动时间。
别把测试失败或未完成的内容写进提交,先处理好再提交。实际操作的时候,建议先在 提交信息 里按这个顺序完整走一遍,第一次别急着提速,跑通之后再把这套动作固定下来,后面遇到同类需求直接复用就行。
别忽略关联信息,该带的编号、该提的 breaking change 都要带上。如果一次没拿到理想结果,别整段推翻重写,把不满意的地方具体指出来让它局部调整,提交信息 在这类细修上比从头再来快很多。
写在最后
好的提交信息是写给未来的备忘。让 Codex 基于 diff 生成,你负责把关格式和准确性,速度和质量能兼顾。
今天就把你团队的提交格式写成模板交给它,试一条看看效果,慢慢把历史质量提上来。