SuperAPI AI 工具集

git-commit

通用与其它

查看项目

更新于 10-15 17:30

技能介绍

用途:该技能用于创建符合 Conventional Commits 规范的语义化 git 提交,当用户要求提交改动或创建 git 提交时触发。

主要能力:先分析真实 diff 判断合适的提交类型、范围与描述,再执行智能暂存与提交。支持的提交类型包括 feat(新功能)、fix(修复)、docs、style、refactor、perf、test、build、ci、chore、revert。支持破坏性变更标记,如在类型或范围后加感叹号(如 feat!: 移除弃用端点),或在页脚使用 BREAKING CHANGE。

使用方式:工作流先加载项目上下文(若存在 docs/SUMMARY.md 优先读取),再分析差异:已暂存用 git diff --staged,未暂存用 git diff,并查看 git status --porcelain。随后按需暂存,可用 git add 指定文件或模式,或用 git add -p 交互暂存。生成信息后提交,单行用 git commit -m "<type>[scope]: <description>",多行用带 heredoc 的命令写入正文与页脚。

最佳实践:每次提交只包含一个逻辑变更;使用现在时与祈使语气;可引用议题(Closes #123、Refs #456);描述少于 72 字符。

限制与安全:绝不提交密钥(如 .env、credentials.json、私钥);绝不擅自修改 git 配置;未经明确要求不执行破坏性命令(--force、hard reset);未经用户要求不跳过钩子(--no-verify);不向 main/master 强制推送;若因钩子导致提交失败,应修复后创建新提交而非 amend;未经用户要求不得自动添加共同作者页脚,需先询问是否添加及添加对象。其他收费、平台与效果信息暂未提供。