SuperAPI AI 工具集

git-commit

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

用途:按 Conventional Commits 规范创建标准化、语义化的 git 提交,通过分析实际 diff 确定合适的类型、作用域和信息。

主要能力:分析 diff 判断变更性质;智能暂存文件;生成提交信息并执行提交。提交格式为 <type>[optional scope]: <description>,可带 body 与 footer。支持的类型包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。破坏性变更可用类型/作用域后的感叹号(如 feat!: remove deprecated endpoint)或 BREAKING CHANGE footer 标注。

使用方式:先分析差异,已暂存用 git diff --staged,未暂存用 git diff,并可用 git status --porcelain 查看状态;需要时用 git add 具体文件、模式或 git add -p 交互式暂存;随后生成信息并提交,单行用 git commit -m "<type>[scope]: <description>",多行用带 heredoc 的 git commit。

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

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