SuperAPI AI 工具集

git-commit

通用与其它

查看项目

更新于 10-15 20:09

技能介绍

用途:按 Conventional Commits 规范创建语义化、标准化的 git 提交,通过分析实际 diff 判断合适的类型、范围与描述。

格式:<type>[可选 scope]: <描述>,可附 body 与 footer。类型包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert。破坏性变更可用类型/范围后加感叹号(如 feat!: ...),或用 BREAKING CHANGE footer 说明。

工作流:1) 分析 diff:已暂存用 git diff --staged,无暂存用 git diff,并查看 git status --porcelain;2) 按需暂存:git add 指定文件、git add .test.、git add src/components/*,或交互式 git add -p。禁止提交密钥(.env、credentials.json、私钥)。3) 生成信息:确定类型、范围、一行描述(现在时、祈使语气、少于 72 字符)。4) 执行:单行用 git commit -m "<type>[scope]: <description>",多行用 heredoc 方式提交 body 与 footer。

最佳实践:一次提交一个逻辑变更;使用现在时与祈使语气;引用议题如 Closes #123、Refs #456;描述控制在 72 字符内。

安全约定:不更新 git config;未经明确要求不执行破坏性命令(--force、hard reset);不跳过钩子(--no-verify),除非用户要求;不对 main/master 强制推送;若因钩子失败,修复后新建提交而非 amend。未经用户要求不自动添加 Co-authored-by trailer,需先询问是否添加及具体协作者。

限制:具体安装与调用方式资料未提供;收费、平台等信息暂未提供。