Codex写Commit你敢全自动？Git Hook + Codex 自动生成提交说明，分享方案或翻车示例

1. 为什么我不建议你让 Codex 全自动写 Commit先说结论Codex 写 commit message 这件事上限确实比大多数人手写要高但如果你把它做成「commit 一敲就自动生成并提交」那基本等于把版本控制权交给了一个概率模型。我试过在个人项目里全自动跑了两周翻车两次之后老老实实改回了半自动。这篇要聊的是用 Git Hook具体是prepare-commit-msg触发 Codex 生成提交说明通过 TaoToken 统一走 Key/API 通道把「生成」和「提交」这两步拆开。生成可以自动提交必须人工确认。适合谁适合已经在用 AI 辅助编码、但还没敢碰 commit 环节的开发者也适合已经被 AI 生成的垃圾 commit message 污染过 log 的人。核心检索词就三个Codex、Git Hook、自动生成提交说明。下面会给出可直接复制的钩子脚本骨架、TaoToken 的接入方式、一次正常提交的完整演示、一次翻车的复现步骤以及回滚和人工兜底的验证动作。全程不涉及任何网络工具只走标准 HTTPS API。2. TaoToken 前置统一 Key 与 API 通道在写钩子之前先把「AI 从哪来」这件事定下来。钩子脚本本身不复杂复杂的是 Key 管理——你总不想在每个项目的.git/hooks里硬编码一堆不同厂商的 Key。TaoToken 在这里的作用是提供一个统一的 API 入口Codex、Claude 这类模型走同一个 base URL 和同一套 Key钩子脚本里只需要读一个环境变量。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 这个不加 UTM。你需要做的准备只有两步第一在控制台创建一个 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后复制出来形如sk-xxxx。这个 Key 只显示一次丢了就重建。第二把它写进 shell 环境不要写进仓库。在~/.zshrc或~/.bashrc里加一行export TAOTOKEN_API_KEYsk-你的key然后source ~/.zshrc生效。验证一下echo $TAOTOKEN_API_KEY | head -c 8能打印出sk-开头的前几位就说明环境变量挂上了。这一步很关键因为后面钩子脚本会读这个变量而不是读仓库里的配置文件——仓库里的东西是会跟着git clone跑出去的。注意绝对不要把 Key 写进.git/hooks/prepare-commit-msg脚本本身也不要用git config存到仓库级配置里。钩子脚本是会被提交到仓库的如果你用了 husky 之类的工具Key 一旦进去就是泄露。如果你还没决定用哪个模型可以先在模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 里试几条 diff看看生成质量再定。长期做编码和 Agent 的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 会更划算这个后面再说。3. 可复制配置prepare-commit-msg 钩子脚本骨架Git Hook 有好几种这里选prepare-commit-msg而不是pre-commit原因是prepare-commit-msg在 Git 打开编辑器之前触发此时 commit message 文件已经存在但还没写内容正好适合「填入 AI 生成的候选」。而pre-commit更适合跑 lint 和测试不该干生成文案的活。3.1 钩子脚本本体在项目根目录创建.git/hooks/prepare-commit-msg注意没有扩展名内容如下#!/usr/bin/env bash # prepare-commit-msg: 调用 Codex 生成 commit message 候选 # 参数: $1 commit message 文件路径, $2 提交来源(如 message/template/merge/squash) MSG_FILE$1 COMMIT_SOURCE$2 # 只在普通提交时生成merge/squash/amend 不干预 if [ -n $COMMIT_SOURCE ]; then exit 0 fi # 如果用户已经手写了 message不覆盖 if [ -s $MSG_FILE ] ! grep -q ^# Please enter $MSG_FILE; then exit 0 fi # 检查 Key if [ -z $TAOTOKEN_API_KEY ]; then echo [hook] TAOTOKEN_API_KEY 未设置跳过 AI 生成 2 exit 0 fi # 取暂存区 diff限制行数防止 token 爆炸 DIFF$(git diff --cached --unified3) DIFF_LINES$(echo $DIFF | wc -l | tr -d ) if [ $DIFF_LINES -gt 200 ]; then echo [hook] diff 超过 200 行($DIFF_LINES)跳过 AI 生成请手写 2 exit 0 fi if [ -z $DIFF ]; then exit 0 fi # 敏感词预检命中直接中断 if echo $DIFF | grep -qiE API_KEY|password|secret|token|BEGIN RSA; then echo [hook] 检测到疑似敏感信息已中断 AI 生成 2 exit 1 fi # 组装请求体 PROMPT你是一个资深工程师。请基于以下 diff 编写简洁的 commit message遵循 Conventional Commits 规范(feat/fix/refactor/docs/chore)。只输出一行 message不要解释不要 markdown 代码块。如果 diff 中包含调试日志或敏感信息输出 chore: needs manual review。\n\nDIFF:\n$DIFF PAYLOAD$(jq -n \ --arg model gpt-5-codex \ --arg content $PROMPT \ {model: $model, messages: [{role: user, content: $content}], max_tokens: 120, temperature: 0.3}) # 调用 TaoToken 统一通道 RESPONSE$(curl -s -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d $PAYLOAD) SUGGESTION$(echo $RESPONSE | jq -r .choices[0].message.content // empty | head -n 1 | sed s/^[[:space:]]*//;s/[[:space:]]*$//) if [ -z $SUGGESTION ]; then echo [hook] AI 未返回有效内容保留原 message 文件 2 exit 0 fi # 写入候选保留原有注释行 { echo $SUGGESTION echo cat $MSG_FILE } $MSG_FILE.tmp mv $MSG_FILE.tmp $MSG_FILE echo [hook] 已生成候选: $SUGGESTION 2给脚本加执行权限chmod x .git/hooks/prepare-commit-msg3.2 关键参数说明参数作用建议值--unified3diff 上下文行数3够用且省 tokenDIFF_LINES阈值超过则跳过200大批量改动 AI 写不准max_tokens限制输出长度120commit message 不需要长temperature随机性0.3要稳定不要创意model模型名按 TaoToken 文档填当前可用名注意jq是必须依赖macOS 用brew install jqUbuntu 用apt install jq。没有 jq 的话脚本会在组装 JSON 那步直接失败。3.3 用 husky 管理团队协作场景个人项目直接放.git/hooks就行但团队项目里.git/hooks不会跟着仓库走。这时候用 huskynpm install husky --save-dev npx husky init然后把上面的脚本内容放到.husky/prepare-commit-msg去掉 shebang 之外的.git/hooks路径依赖即可。husky 会自动把钩子链接到.git/hooks。4. 验证请求一次正常提交的完整过程配置好之后走一遍正常流程。4.1 准备一个干净的改动mkdir demo-repo cd demo-repo git init echo console.log(hello) app.js git add app.js4.2 执行提交git commit此时钩子触发终端会先打印[hook] 已生成候选: feat: add initial app entry with hello log然后 Git 打开编辑器你会看到 message 文件顶部已经填好了这行候选下面是你原来的注释模板。直接保存退出提交完成。4.3 验证结果git log --oneline -1输出类似a1b2c3d feat: add initial app entry with hello log符合 Conventional Commits 规范类型、范围、描述都在。这就是「半自动」的正常形态AI 填候选你按 Enter 确认。4.4 验证 API 通道是否真的通了如果钩子没输出候选先单独测一次 APIcurl -s -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d {model:gpt-5-codex,messages:[{role:user,content:回复 OK}],max_tokens:10}返回里有choices字段就说明 Key 和通道都正常问题出在钩子脚本逻辑上。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的请求/响应格式说明。5. 翻车复现生成空说明与覆盖手写信息现在说翻车。这两种我都在真实项目里遇到过下面给出可复现的步骤。5.1 翻车一生成空说明复现步骤把max_tokens改成 5或者把模型名写成一个不存在的名字。# 修改脚本里的 model 为 gpt-5-codex-typo git add app.js git commit结果API 返回 404 或空choicesSUGGESTION为空。此时脚本里if [ -z $SUGGESTION ]会拦住保留原 message 文件——这是兜底逻辑救了你。但如果你把兜底那几行删了message 文件会被写成一个空行Git 会直接报Aborting commit due to empty commit message你得重新git commit。更隐蔽的一种模型返回了内容但内容是\n或纯空格。head -n 1之后变成空字符串-z判断能拦住但如果模型返回的是 一个空格-z判断为假就会写入一个只有空格的 messageGit 同样会拒绝。修复动作在写入前加一道 trim 校验SUGGESTION$(echo $SUGGESTION | tr -d [:space:]) if [ -z $SUGGESTION ]; then exit 0 fi5.2 翻车二覆盖手写信息这个更危险。复现步骤先手写 message再触发钩子。git commit -m fix: 修复登录态丢失的边界问题等等-m模式下prepare-commit-msg的$2参数是message脚本里if [ -n $COMMIT_SOURCE ]会直接exit 0不会覆盖。所以-m是安全的。真正会翻车的是你打开编辑器手写了一半钩子在你写之前已经把候选写进去了你以为那是你写的直接保存——结果提交的是 AI 的候选不是你的原意。或者更糟你的脚本里没有if [ -s $MSG_FILE ]那道判断用户手写的内容被 AI 候选整个覆盖。复现# 删掉脚本里的 如果用户已经手写了 message不覆盖 那段 git add app.js git commit # 在编辑器里手写 fix: 重要修复 # 保存退出 git log --oneline -1如果脚本没有保护你会看到提交的是 AI 候选而不是你手写的。修复动作就是保留if [ -s $MSG_FILE ]判断并且在写入时用「追加」而不是「覆盖」——上面脚本里用的是echo $SUGGESTION然后cat $MSG_FILE候选在前、原文在后用户能看到两者。5.3 回滚动作如果已经提交了错误的 message回滚很简单# 只改 message不动代码 git commit --amend -m fix: 正确的说明 # 如果已经 push 了且是个人分支 git push --force-with-lease # 如果是共享分支不要 force push用 revert 或跟团队沟通--force-with-lease比--force安全它会在远程有你不知道的新提交时拒绝推送。5.4 人工兜底验证清单每次提交前花 5 秒过一遍git diff --cached --stat看一眼改了哪些文件和 message 描述是否对得上message 里有没有出现remove、delete这类词但 diff 里其实只是移动了代码有没有console.log、debugger、print被写进 message 当成 feature敏感词预检有没有被绕过比如pass_word这种变体6. 常见错排查与 CTA6.1 钩子不触发最常见原因文件没有执行权限。chmod x .git/hooks/prepare-commit-msg解决。其次是文件名写错必须是prepare-commit-msg不是prepare-commit-msg.sh。6.2 jq 报错parse error说明 API 返回的不是合法 JSON通常是 Key 无效或额度不足。先用 4.4 的 curl 单独测一次看返回体里有没有error字段。Key 相关的问题去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 检查状态。6.3 生成内容带 markdown 代码块模型有时候会返回feat: xxx。在脚本里加一道清洗SUGGESTION$(echo $SUGGESTION | sed s/[a-z]*//g | tr -d )6.4 diff 太大导致超时200 行阈值就是干这个的。如果你的改动确实大拆成多个 commit每个 commit 只做一件事AI 生成质量也会更高。6.5 团队里有人没配 Key钩子脚本里if [ -z $TAOTOKEN_API_KEY ]会跳过生成不会阻塞提交。这是有意的设计——AI 是增强不是依赖。6.6 长期编码场景的通道选择如果你每天都在用 Codex 做编码和 Agent 任务单次调用走 API 不如用 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 额度更稳。Claude Code 相关的接入方式在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-codeutm_campaignrewrite 有说明钩子脚本里的 model 字段换成对应模型名即可请求格式不变。最后留一句实在话这套方案的价值不在于「省了写 message 的 10 秒」而在于它逼你把 diff 拆小、把敏感信息挡在提交之前。全自动 commit 我劝你别碰半自动加人工守门才是能长期跑下去的形态。