SuperAPI AI 工具集

git-commit

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:按 Conventional Commits 规范创建标准化、语义化的 git 提交。通过分析实际 diff 确定合适的类型、范围与提交信息,并在需要时智能暂存文件后执行提交。

提交格式:<type>[可选 scope]: <描述>,可附可选正文与页脚。支持的类型包括 feat(新功能)、fix(缺陷修复)、docs(仅文档)、style(格式,无逻辑变更)、refactor(重构)、perf(性能优化)、test(测试)、build(构建系统/依赖)、ci(CI/配置)、chore(维护杂项)、revert(回滚)。破坏性变更可用类型/范围后的感叹号(如 feat!: remove deprecated endpoint)或 BREAKING CHANGE 页脚标注。

工作流程:先分析 diff,已暂存时用 git diff --staged,未暂存时用 git diff,并用 git status --porcelain 查看状态;再按需暂存,可指定文件、按模式(如 git add .test.)或交互式 git add -p;随后依据 diff 判断类型、范围与一行描述(现在时、祈使语气、72 字符内);最后执行提交,单行用 git commit -m "<type>[scope]: <description>",多行用 heredoc 形式附带正文与页脚。

最佳实践:每次提交只包含一个逻辑变更;使用现在时与祈使语气;通过 Closes #123、Refs #456 关联 issue;描述控制在 72 字符内。

安全约束:绝不修改 git config;未经明确要求不执行破坏性命令(--force、hard reset);除非用户要求不跳过钩子(--no-verify);不向 main/master 强制推送;若因钩子导致提交失败,应修复后创建新提交而非 amend。同时不得提交密钥类文件(.env、credentials.json、私钥)。

适用场景:用户要求提交改动、创建 git 提交,或需要按规范整理提交信息时。限制:具体安装方式与运行环境资料暂未提供。