用途:在改动已被暂存后,从暂存区创建 Git 提交。
主要能力:提交前先检查暂存内容;若没有文件处于暂存状态,则停止并报告暂无可提交内容;按固定结构撰写英文提交信息;仅提交已暂存的改动。
使用方式:先用 git diff --cached --name-status 和 git diff --cached 分别查看暂存文件名状态与具体差异;每条命令单独作为一次 Bash 工具调用,除非确实需要 shell 特性,否则不要用 &&、;、管道、重定向、包装 echo 行或其他 shell 拼接方式合并命令。若没有暂存文件则停止并报告。提交信息使用英文,主题行为一句简单句子、首字母大写,不使用 fix:、feat:、chore:、docs: 等约定式前缀;正文用详细的项目符号说明关键代码或行为变更,主题保持简洁具体,正文保持事实性与实现导向。然后以单次 Bash 工具调用执行 git commit。
限制:只提交已暂存的改动,除非用户明确要求,不得额外暂存文件;若提交钩子失败,应报告确切的失败信息与下一步可执行操作。