
本文介绍一种轻量、可定制的 CLI 方案,通过封装 git add、获取暂存区差异、调用 AI 工具生成语义化提交信息,并交互式确认提交,实现“添加即准备提交”的高效工作流。
本文介绍一种轻量、可定制的 cli 方案,通过封装 `git add`、获取暂存区差异、调用 ai 工具生成语义化提交信息,并交互式确认提交,实现“添加即准备提交”的高效工作流。
Git 本身并未提供 post-add 钩子(如 post-add 或 after-add),因此无法像 pre-commit 或 commit-msg 那样通过标准 Git Hooks 在 git add 后自动执行逻辑。但我们可以绕过这一限制,将 git add 与后续流程封装为一个原子化命令——本质上是构建一个自定义 Git 子命令(如 git add-and-prepare),既保持操作直觉,又完全可控。
以下是推荐的完整实现方案:
✅ 步骤一:编写可执行脚本
创建一个名为 git-add-and-commit 的 Bash 脚本(注意命名符合 Git 子命令规范:git-):
#!/bin/bash
# 检查是否至少有一个参数(文件/路径)
if [ $# -eq 0 ]; then
echo "Usage: git add-and-commit <file...>"
echo "Example: git add-and-commit src/main.js README.md"
exit 1
fi
# 1. 执行 git add
echo "→ Adding files..."
git add "$@"
# 2. 获取暂存区差异(--cached 即 --staged)
echo "→ Fetching staged diff..."
diff=$(git diff --cached --no-color)
# 3. 调用你的 AI 提交消息生成器(替换为你实际的命令)
# 示例:curl、python script、ollama run、gh cli 插件等
if [ -z "$diff" ]; then
echo "⚠️ No changes staged. Nothing to commit."
exit 0
fi
echo "→ Generating AI-powered commit message..."
commit_msg=$(echo "$diff" | your_ai_commit_generator 2>/dev/null)
if [ -z "$commit_msg" ] || [ "$commit_msg" = "null" ]; then
echo "❌ Failed to generate commit message. Please check your AI tool."
exit 1
fi
# 4. 交互确认
echo ""
echo "? Suggested commit message:"
echo "--------------------------"
echo "$commit_msg"
echo "--------------------------"
read -rp "✔️ Confirm and commit? (Y/n): " confirm
confirm=${confirm:-y} # 默认回车视为 'y'
if [[ "$confirm" =~ ^[yY]|[yY][eE][sS]$ ]]; then
git commit -m "$commit_msg"
echo "✅ Committed successfully."
else
echo "➡️ Skipped commit. Files remain staged."
fi</file...>
? 提示:将
your_ai_commit_generator替换为你实际使用的工具,例如:
git-cliff Git 仓库可定制变更日志生成器下载git-cliff 使用约定式提交和正则表达式驱动的自定义解析器从 Git 历史记录中生成变更日志文件。该工具使用 Rust 编写,通过 TOML 配置文件提供高度可定制的模板,并集成了 GitHub Actions、Docker 和 CI/CD 流水线。
python3 ./ai-commit.py(本地 Python 脚本)curl -s http://localhost:8000/generate(本地 LLM API)ollama run qwen:7b "Generate concise conventional commit from this diff:\n$diff"gh extension exec ai-commit --diff "$diff"(若已开发 GitHub CLI 插件)
✅ 步骤二:安装为 Git 子命令
将脚本保存为 git-add-and-commit,并放入系统 $PATH 中(如 /usr/local/bin/ 或 ~/bin/):
chmod +x git-add-and-commit sudo mv git-add-and-commit /usr/local/bin/ # 或(推荐用户级): mkdir -p ~/bin && mv git-add-and-commit ~/bin/ && export PATH="$HOME/bin:$PATH"
之后即可直接使用:
git add-and-commit app.js utils.ts # 等效于:git add + AI 生成 + 交互确认提交
⚠️ 注意事项与最佳实践
- 安全性:AI 生成器应避免上传敏感代码至公网服务;建议优先使用本地模型(如 Ollama、LM Studio)或可信内网 API。
- 空暂存区处理:脚本已内置检查,防止无变更时误触发生成逻辑。
- Git 状态兼容性:该命令不干扰其他 Git 流程,失败时暂存区状态保持不变,可安全重试。
-
扩展性:支持传入任意
git add参数(如-p、-u),只需稍作适配(当前版本支持路径参数;如需支持选项,可用getopts增强)。 -
调试建议:首次运行前,先手动执行
git diff --cached和your_ai_commit_generator验证输出格式是否匹配。
通过这个方案,你无需修改 Git 配置、不依赖全局钩子、不侵入团队协作流程,就能以极低耦合度实现「添加即智能准备」的现代化提交体验——让高质量提交信息成为习惯,而非负担。











