SuperAPI AI 工具集

git-commit

编程与开发

查看项目

更新于 10-16 08:11

技能介绍

用途:按 Conventional Commits 规范创建标准化、语义化的 Git 提交。分析实际 diff 来确定合适的类型、范围与消息。

提交格式:<type>[可选 scope]: <description>,可带可选 body 与 footer。

类型:feat 新功能、fix 修复缺陷、docs 仅文档、style 格式(无逻辑)、refactor 重构、perf 性能、test 测试、build 构建/依赖、ci 配置、chore 杂项、revert 回滚。破坏性变更可用类型后加感叹号(如 feat!:)或在 footer 写 BREAKING CHANGE。

工作流:先分析 diff,已暂存用 git diff --staged,否则用 git diff,并查看 git status --porcelain;若未暂存或需分组,可用 git add 指定文件、模式或 git add -p 交互暂存;再生成消息;最后用 git commit -m 提交单行或 heredoc 多行消息。

最佳实践:每次提交一项逻辑变更;使用现在时和祈使语气(add 而非 added);引用议题如 Closes #123;描述保持在 72 字符以内。

安全限制:绝不更新 git config;未经明确要求不执行 --force、硬重置等破坏性命令;未经用户同意不跳过钩子(--no-verify);不强制推送到 main/master;绝不提交密钥(.env、credentials.json、私钥)。若因钩子提交失败,应修复并创建新提交,而非 amend。