首页/新闻资讯/正文详情

用 AI 写 Git Commit Message,别踩这 5 个坑

发布时间:2026/9/27 7:47:15 来源:云帆数科 栏目:资讯中心
用 AI 写 Git Commit Message,别踩这 5 个坑
目录一、先定规则AI 只写文案不碰仓库动作二、可复制 Prompt按 staged diff 用三、Conventional Commits 速查给 AI 也给你四、五个坑坑 1工作区全量当 staged坑 2一条 commit 揉进两件事坑 3复述 diff不写动机坑 4type 选飘坑 5自动提交 / 自动 push五、和 PR 描述怎么分工六、什么时候不用 AI小结写 commit message 这件事烦的不是「想不出来」是改了一堆文件之后已经懒得准确概括了。于是两种极端很常见要么随手来一句update/fix半年后git blame等于没有要么把 AI 生成的长文原样贴上去subject 80 个字body 里还在复述 diff 里一目了然的细节。这篇讲我怎么让 AI 写 commit以及五个真实踩过的坑。附可复制 Prompt 和 Conventional Commits 模板。一、先定规则AI 只写文案不碰仓库动作这是底线建议写进个人习惯甚至团队约定AI 可以做AI 不要做根据staged diff起草 message自动git commit除非你显式确认按团队规范改写 subject/body自动git push把乱七八糟的草稿收成规范格式擅自git add未审查文件提醒「这次 staged 像是混了两件事」改历史rebase/amend除非你要求一句话生成归生成提交的按钮永远在人手里。二、可复制 Prompt按 staged diff 用把git diff --cached的结果贴进去或让编辑器把 staged 变更喂给 AI根据下面的 staged diff写一条 Git commit message。 规范 - 使用 Conventional Commits - subjecttype(scope): 摘要不超过 72 字符祈使句不加句号 - type 仅用feat / fix / refactor / docs / test / chore / perf / ci - body 可选有则说明「为什么」和「影响」不要逐文件复述 diff - 中文或英文与团队现有 log 保持一致本仓库用____ 约束 - 只描述 staged 里真实存在的变更禁止猜测未出现的动机 - 若 staged 明显包含两件无关的事先指出并给出「拆成两条」的建议不要硬揉成一条 - 不要加入 Co-authored-by、emoji除非我要求 - 输出两个候选我来选 staged diff 粘贴 git diff --cached把「本仓库用」那一行改成中文或英文。候选给两条很有用一条偏短、一条带 body选起来快。我在 wescode 里会直接对当前变更说「按 Conventional Commits 写 commit message给两个候选」逻辑和上面一样关键是范围锁定在 staged别让它根据整个工作区幻想。三、Conventional Commits 速查给 AI 也给你type(scope): subject [body] [footer]常用 typetype何时用feat新功能fix修 bugrefactor行为不变的结构整理docs只改文档test只改测试chore构建/工具/杂项perf性能ciCI 配置好的 subject 例子feat(auth): 支持 refresh token 轮转 fix(download): 修复断点续传校验和为空 refactor(store): 拆分 ListBuilds 查询逻辑差的 subjectAI 也常写出来update code fix bug 优化了一些东西 Update auth.go and handler.go四、五个坑坑 1工作区全量当 staged未git add的文件、本地调试打印、半成品实验AI 若看到整个工作区会写进 message。结果是message 描述了你没打算提交的东西或反过来真正 staged 的要点被稀释。习惯先git add -p或按文件 add→ 再生成。只喂git diff --cached。坑 2一条 commit 揉进两件事改了登录又顺手格式化了无关包。AI 常会写feat(auth): 登录支持 MFA 并统一代码风格看起来完整回滚和 cherry-pick 会很痛。正确反应是让 AI 指出混杂然后拆 commit而不是追求「一条说完」。Prompt 里那句「两件无关的事先指出」就是为这个准备的。坑 3复述 diff不写动机AI 默认爱写- 修改了 a.go - 新增了 b.go - 删除了 c.go这是git show --stat就能看到的。body 该写的是为什么改缺陷表现、需求背景有意不做的取舍「暂不迁移旧接口」风险提示「需跑迁移」「兼容旧客户端」生成后扫一眼body 里如果全是文件名删掉重写「为什么」。坑 4type 选飘把「修文案」写成feat把「真的新接口」写成chore后面按 type 筛 changelog / 自动发版会乱。简单校准用户可感知的能力变化 →feat/fix只有开发者在意 →refactor/test/chore拿不准时看「用户会不会在发版说明里看到它」坑 5自动提交 / 自动 push部分工具或脚本支持「生成并 commit」。省事的代价是message 还没看就进历史了误 add 的文件一起进去了钩子lint-staged、测试失败时更难收拾我的做法永远先展示候选 → 人确认 → 再手动 commit。AI 加速的是措辞不是跳过审查。五、和 PR 描述怎么分工产物该写什么commit message这一小步「做了什么 为何」PR 描述整单动机、测试计划、风险、截图/关联 issue别让 AI 把 PR 长文塞进每一条 commit也别指望一条feat: ...能代替 PR。我的常用顺序本地多次小 commitAI 助写 message开 PR 时再让 AI 根据main...HEAD的 log diff 写 PR 描述PR 描述里单独要「测试计划」和「风险」commit 里不必重复六、什么时候不用 AI改动就一行、意图一眼能看清。自己敲fix(api): 纠正空指针更快。message 需要写进合规/审计语境。涉及安全修复措辞、对外披露口径时人定稿AI 最多给草稿。你还没 staged、自己都没理清改了什么。先整理 diff再写 message顺序反了AI 只会帮你把混乱写得很流畅。小结用 AI 写 commit message收益很大但只在三个前提下输入是staged diff不是整个乱七八糟的工作区输出遵守团队规范并且人确认后再 commit发现「一条里两件事」时选择拆分而不是硬概括Subject 写动机与范围body 写为什么别让 AI 当你的git status复读机。上面的 Prompt 和流程我是在日常提交里用的编辑器侧用的是 wescode官网是 weisyn.com。你们团队对 AI 写 commit 还有什么强制规范欢迎评论区贴出来一起抄作业。

相关推荐

有凡客模版怎么建设网站新手避坑对比评测指南
有凡客模版怎么建设网站新手避坑对比评测指南

有凡客模版怎么建设网站新手避坑对比评测指南 备案流程一头雾水?手里拿着凡客时代的经典模板,却卡在服务器配置和域名解析上,看着满屏的技术术语想放弃。别慌,我见过太多刚入行的运营和开发者,手里握着不错的视觉资源,却因为搞不定底层环境,导致网站上… · 2026/9/27 7:47:15

Model-Optimizer 集群 PTQ 实战指南:SLURM 容器、GPU 规模估算与冒烟测试全流程
Model-Optimizer 集群 PTQ 实战指南:SLURM 容器、GPU 规模估算与冒烟测试全流程

人工智能大模型模型优化模型量化模型压缩 【免费下载链接】Model-Optimizer A unified library of SOTA model optimization techniques like quantization, distillation, pruning, neural architecture search, speculative decoding, etc. It compresses deep learning mode… · 2026/9/27 7:47:15

max转fbx,gltf,glb,obj,stl等通用格式文件,无需安装3dsmax和任何软件,直接转换
max转fbx,gltf,glb,obj,stl等通用格式文件,无需安装3dsmax和任何软件,直接转换

赵山河 MAX 通用转换器 是一款面向 3ds Max 模型文件的独立格式转换工具。它最大的特点是不需要安装 3ds Max、Blender 等大型三维软件,就可以直接读取 .max 文件,并转换为 FBX、GLB、glTF、OBJ、STL、PLY、DAE、3DS 等常用三维格式。整个转换过程可以在… · 2026/9/27 7:47:09

Deepsec 提示词引擎实战拆解:Go 多框架(Gin + Chi)批量扫描的 Agent 审查提示词是如何生成与校验的
Deepsec 提示词引擎实战拆解:Go 多框架(Gin + Chi)批量扫描的 Agent 审查提示词是如何生成与校验的

应用安全漏洞扫描人工智能AI Agent 【免费下载链接】deepsec Deepsec is a security harness for finding vulnerabilities in your codebase powered by coding agents 项目地址: https://gitcode.com/gh_mirrors/deeps/deepsec 点击查看 免费下载 导读 本文以 p… · 2026/9/27 8:24:24

open-slide 设计工程实战:基于 Emil Kowalski 动画决策框架打磨幻灯片细节体验
open-slide 设计工程实战:基于 Emil Kowalski 动画决策框架打磨幻灯片细节体验

【免费下载链接】open-slide A slide framework built for agents. 项目地址: https://gitcode.com/gh_mirrors/op/open-slide 点击查看 免费下载 open-slide 是一款为 Agent 而生的幻灯片框架,它把"演示体验"本身当作一等公民:页… · 2026/9/27 8:24:17

2026最新解析:旅游网站建设属于什么以及学科,解决没人访问难题
2026最新解析:旅游网站建设属于什么以及学科,解决没人访问难题

2026最新解析:旅游网站建设属于什么以及学科,解决没人访问难题 网站上线三个月,后台流量曲线几乎是一条死线,每天个位数的IP,连蜘蛛抓取记录都寥寥无几。这种“网站做好了没人访问”的绝望感,是无数旅游企业建站后最真实的痛点。很多人误以为只要… · 2026/9/27 8:24:17

F2 玫瑰图(南丁格尔玫瑰图)开发指南:用极坐标半径表达数据大小
F2 玫瑰图(南丁格尔玫瑰图)开发指南:用极坐标半径表达数据大小

数据可视化前端 【免费下载链接】F2 📱📈An elegant, interactive and flexible charting library for mobile. 项目地址: https://gitcode.com/gh_mirrors/f2/F2 点击查看 免费下载 导读 玫瑰图(Rose Chart)&#x… · 2026/9/27 8:24:11

电脑虚拟主机避坑指南:5个关键注意事项教你省下30%预算
电脑虚拟主机避坑指南:5个关键注意事项教你省下30%预算

电脑虚拟主机避坑指南:5个关键注意事项教你省下30%预算 找建站公司怕被坑高价?别急,先看看你选的电脑虚拟主机是否踩了这些坑。很多站长花了大价钱,网站却卡得像PPT,核心问题往往出在虚拟主机的 注意事项… · 2026/9/27 8:24:05

如何攻击Wordpress站点常见报错与解决
如何攻击Wordpress站点常见报错与解决

5个WordPress安全陷阱与防御注意事项 改个需求建站公司拖一周,这种憋屈感谁懂?刚上线的WordPress站点,后台改个按钮颜色,外包团队说“底层逻辑冲突”,得排期。结果第二天网站直接变白屏,或者更糟——被黑客植入了恶意代码,SEO收… · 2026/9/27 8:23:47

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现
MATLAB雷达信号脉冲压缩仿真:LFM线性调频、匹配滤波与距离分辨率实现

简介:这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程,从线性调频(LFM)信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑,面向电子信息工程、计算机、数学等专业学生,适用于课程设计、期末大作… · 2026/9/27 0:00:01

汕头网站建设制作厂家避坑指南:5大注意事项救急
汕头网站建设制作厂家避坑指南:5大注意事项救急

汕头网站建设制作厂家避坑指南:5大注意事项救急 改个需求建站公司拖一周,这种憋屈事我见得太多了。 很多汕头老板找本地建站团队,签合同前看着方案挺美,一上线就变脸。 今天不聊虚的,直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01

多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习
多模态虚假新闻检测实战:BERT+ResNet双塔与对比学习

简介:基于PyTorch的多模态虚假新闻检测项目完整代码包,面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者,解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征,以Res… · 2026/9/27 0:00:01

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码