SuperAPI AI 工具集

git-commit-message

通用与其它

查看项目

更新于 10-15 17:19

技能介绍

用途:分析已暂存的 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)仅摘要行加可选说明,摘要最多 72 字符。

使用方式:在 /commit-msg 命令调用、commit-msg/prepare-commit-msg 钩子触发或用户请求建议时激活。流程为先运行 git diff --staged --name-status、git diff --staged --stat、git diff --staged,再加载 config.yaml,分析变更、判定类型与层级,生成主建议与备选,最后按规则校验。支持可选模式 --validate "<message>"、--tier <1|2|3>、--interactive 或 -i。建议用 git add <file1> <file2> 精确暂存,沙箱环境避免 heredoc。

限制:不提供安装命令与具体价格信息;自动类型检测可能遗漏上下文,生成信息需人工复核;配置项依赖项目自身的 config.yaml;禁用泛化信息与助手/工具署名,WIP 标记会被警告。缺失事实:未提供支持的平台与收费方式。