SuperAPI AI 工具集

git-commit-message

通用与其它

查看项目

更新于 10-16 01:26

技能介绍

用途:分析暂存的 git 变更,推断变更类型与范围,生成简洁、有意义的 Conventional Commits 提交信息,并按提交重要程度采用三级格式。

主要能力:解析 git diff --staged 输出,识别新增、修改、删除的文件并检测跨文件模式;从变更推断提交类型(feat、fix、security、refactor、docs、style、test、chore、perf、ci、build、revert);从目录名、文件名模式与框架约定推断 scope;生成 type(scope): description 格式信息,使用祈使语气,并提供 2-3 个备选建议。三级格式:Tier 1(feat、fix、perf、security)要求详细说明与影响声明,摘要行最多 50 字符;Tier 2(refactor、test、build、ci)要求简要上下文与文件列表,摘要行最多 72 字符;Tier 3(docs、style、chore)只需摘要行,可选补充说明。

使用方式:在调用 /commit-msg 命令、从 commit-msg/prepare-commit-msg 钩子触发、用户请求提交信息建议或提交前分析变更时激活。工作流包括:如项目使用 TypeScript,暂存前对变更文件运行 tsc --noEmit;用 git diff --staged --name-status、git diff --staged --stat、git diff --staged 获取暂存变更;加载 config.yaml;分析变更并确定层级;生成主建议与备选;按规则校验;向用户展示并说明层级。可选模式包括 --validate "<message>" 校验信息、--tier <1|2|3> 强制层级、--interactive 或 -i 交互确认。

适用场景:需要规范化提交历史的项目、多包仓库的 scope 管理、变更日志生成、安全敏感提交的审计记录。

限制:AI 生成的信息需人工复核与修改;自动类型检测可能遗漏上下文;安全提交始终需要人工判断。校验会阻止含糊信息(如 "Update files")与助手/工具署名,WIP 标记会给出警告。资料未提供具体收费、价格与平台支持信息。