3 条命令跑起来：git-rewrite-commits 用 AI 自动改写 Git 提交信息

3 条命令跑起来git-rewrite-commits 用 AI 自动改写 Git 提交信息【免费下载链接】nekoA self hosted virtual browser that runs in docker and uses WebRTC.项目地址: https://gitcode.com/GitHub_Trending/ne/neko打开git log翻历史满屏的 fix、update三个月后连自己都不知道当时改了什么——这种困扰用过 Git 的人大概率都遇到过。git-rewrite-commits 是一款 AI 提交信息改写工具它调用 OpenAI 或 Ollama 等模型把你暂存区里的变更自动改写成符合约定式提交规范的文本新手和老手都能直接用。效果对比AI 提交信息改写的实际样子看效果最直观改写前往往只有一句含糊的修了个 bug改写后信息明显分层——类型feat、fix、docs一眼看出变更性质作用域点明受影响的模块描述则把具体做了什么说清楚。几次积累下来git log不再是天书而是一份能直接当 changelog 读的记录。上手篇安装 Git 钩子三条命令跑起来流程很短三步走完git clone https://gitcode.com/GitHub_Trending/ne/neko克隆完成后配置模型密钥。用 OpenAI 的话导出密钥即可export OPENAI_API_KEYyour-api-key如果本地跑了 Ollama 服务则不需要密钥选择对应的本地提供程序就行。最后一条命令把 Git 钩子装进仓库npx git-rewrite-commits --install-hooks装好之后你的操作习惯完全不用变照旧git add .、git commit编辑器弹出来时✨ 规范的提交信息已经替你写好了看一眼没问题直接保存即可。机制篇三个 Git 钩子如何接力工作整个工具其实是一条时间线上的接力全程不需要你主动调用提交时——你敲git commit的瞬间prepare-commit-msg 钩子被触发。它读取暂存区的 diff交给 AI 模型生成一段符合约定式提交的信息直接写进编辑器。这就是你打开编辑器看到已躺好文案的原因。提交后——post-commit 会在提交落库后自动跑一轮检查对没有完全达标的信息再润色一次保证写进历史的内容都是合格的。推送前——pre-push 是最后一道关。执行git push前它会检查尚未推送的提交发现不规范的会提示你处理让远程仓库里的历史始终干净。先代写、再校验、后把关三道工序串下来你只需要在最后做确认这一个动作。定制篇团队提交模板与两层配置配置团队提交模板如果团队有统一的前缀要求比如必须挂 JIRA 编号用模板把格式锁死git config hooks.commitTemplate [JIRA-XXX] feat: message之后 AI 生成的每条信息都会按这个骨架输出整个团队的提交风格自然就对齐了。选择提交信息语言与配置范围提交信息还支持多语言比如设成日语git config hooks.commitLanguage ja西班牙语es、法语fr等同样可用。注意区分范围上面这条只作用于当前仓库加上--global则是全局配置对机器上所有仓库生效适合想统一规范的个人开发者。内部篇这个工具是怎么实现的整体用 TypeScript 编写结构上分三层packages/grec/cli.js 是命令行入口负责参数解析和钩子安装src/providers/ 存放各模型提供程序模块抹平 OpenAI 与 Ollama 之间的调用差异hooks/ 目录则存放 prepare-commit-msg、post-commit、pre-push 三个钩子脚本。排障篇三个常见问题与一行解法⚠️ 遇到报错不用慌多数情况一条命令就能解决提示 API 密钥未设置 →export OPENAI_API_KEYsk-...并写进 shell 配置文件持久化钩子没生效 →ls -la .git/hooks/查看钩子文件是否存在缺了就重新跑npx git-rewrite-commits --install-hooks想卸载钩子 → 直接删除.git/hooks/下对应文件如rm .git/hooks/prepare-commit-msg写在最后git-rewrite-commits 适合两类人想借 AI 生成的规范信息顺带学会约定式提交的新手以及不想在提交信息上耗时间的老手。建议先在一个测试仓库里试两周把模板和语言调到自己顺手再推广到日常项目里。【免费下载链接】nekoA self hosted virtual browser that runs in docker and uses WebRTC.项目地址: https://gitcode.com/GitHub_Trending/ne/neko创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考