[commit-hook] 给 git commit 加了个 AI 质检员，开源求参与

团队 commit message 质量一直是个头疼事——「 fix bug 」「 update code 」满天飞，CR 时大量时间花在纠正描述上。

于是写了 commit-hook：一个 git commit-msg hook ，commit 时自动拿 diff 跟 message 对账，LLM 判定不匹配就拦截并给出改进建议。

仓库： https://github.com/Casper-Mars/commit-hook

目前 MVP 已跑通，Python CLI ，uv tool install 一行装完，commit-hook init 自动配置 hook 。支持 OpenAI / Anthropic / Ollama / 自定义 API 。

发这个帖子主要是想找同路人一起打磨：

提 Issue：边界场景需要更多真实反馈

现在核心链路通了，但我很清楚还有不少需要完善的地方：

• 大 diff 截断策略是否合理？你遇到过被截掉关键变更的情况吗？
• 敏感文件过滤现在走黑名单，是否应该切白名单？
• 团队场景下 [skip-validate] 的权限控制怎么做？
• LLM 判定的准确率怎么量化、怎么持续优化？

如果你的团队有 commit 规范方面的痛点，欢迎开 issue 聊。

提 PR：有几个方向特别适合社区贡献

技术栈 Python 3.10+，uv 管理，结构清晰好上手：

• 输出美化——现在终端红绿字够用，但谁想搞个 TUI 展示评分细节？
• diff 智能摘要——大 diff 场景下的压缩/摘要策略优化
• 多模型对比模式——双模型打分取均值，降低单模型误判
• Windows 兼容——目前在 macOS/Linux 上验证了，Win Git Bash / WSL 需要一起踩坑
• IDE 插件——VSCode / JetBrains 插件，检查结果直接看
• GitHub Action 集成——PR 时自动跑 commit message 质量检查

当然如果你觉得整体设计思路有更好的做法，也欢迎 PR 来辩。

也想听听你的真实看法

• 每次 commit 等几秒 LLM 返回，这个体验你能接受吗？
• 你觉得应该是「拦截模式」还是「 warn 提醒模式」？还是两种都要？
• 你们团队目前在用什么方式保证 commit 质量？效果怎么样？

仓库开着，欢迎 issue 、PR 、讨论。👋