Git 提交（中文 commit message）

触发词

用户说以下任意一种时执行：

• "提交改动"、"提交一下"、"提交代码"
• "commit 一下"、"帮我 commit"

流程

第一步：收集信息

并行执行：

git status
git diff --stat
git diff
git diff --cached
git log --oneline -5

第二步：分析改动，决定是否拆分 commit

• 所有改动围绕同一个目的 → 单个 commit
• 改动涉及多个无关目的 → 拆分为多个 commit
• 拆分按逻辑关联性分组，不按文件类型分组

第三步：编写 commit message

格式：

• 第一行：简洁中文摘要，不超过 50 字
• 如有必要，空一行后用 - 列表写详细说明
• 描述做了什么、为什么做，不罗列文件名

示例：

修复用户登录时 token 过期未刷新的问题

- 登录接口返回 401 时自动重试一次
- 刷新 token 失败则跳转登录页

优化圈画交互：悬停高亮同组圈画 + 扩大点击命中区域

第四步：执行提交

• git add 添加相关文件（排除 .env、credentials 等敏感文件）
• 用 HEREDOC 格式传递 commit message：

git commit -m "$(cat <<'EOF'
这里写 commit message
EOF
)"

• 需要拆分时，按顺序逐个 git add + git commit
• 提交后执行 git status 确认结果

第五步：报告结果并询问是否 push

提交完成后报告：

• 本次提交了几个 commit
• 每个 commit 的短 hash 和完整 message
• 当前分支名和状态（领先 remote 几个 commit）

然后主动询问用户是否需要 push，例如：

"以上 2 个 commit 已提交，当前领先 origin/main 2 个 commit。需要 push 吗？"

• 用户确认后才执行 git push
• 用户不回复或拒绝则不 push

注意事项

• 绝不自动 push，必须询问用户确认
• 不修改 git config
• 不使用 --amend，除非用户明确要求且 HEAD 是本次会话创建的
• 没有改动时告诉用户"没有需要提交的改动"