SuperAPI AI 工具集

commit-message

通用与其它

查看项目

更新于 10-15 23:32

技能介绍

用途:分析 git 变更,生成符合 Conventional Commits 规范的上下文感知提交信息,并支持将多个不相关的改动拆分为多次提交。

主要能力:提供 --analyze 查看所有变更文件的状态与分类;--batch 建议如何把变更拆分为多个提交;--generate [pattern] 为匹配文件生成提交信息;--staged 仅分析已暂存的变更(默认分析全部变更)。支持 feat、fix、refactor、docs、test、chore、style 等提交类型。

使用方式:运行 python3 .shared/commit-message/scripts/analyze_changes.py --analyze 分析全部变更;用 --batch 获取批量提交建议;用 --generate "src/api/*.py" 为指定文件生成信息。批量提交时先运行 --batch 查看建议分组,再 git add <files> 暂存第一组并提交,重复处理其余分组。脚本提供文件分组与基础建议,需结合 git diff 理解实际改动后生成上下文感知的信息。

适用场景:创建 git 提交、需要按目录/模块、变更类型或语义关系对改动分组、以及为多平台或第三方集成改动撰写提交信息时。

限制:脚本仅提供分组和基础建议,实际提交信息需人工阅读代码后生成;scope 应反映业务模块或功能而非仅目录;首行应控制在 72 字符以内,使用主动语态。资料未提供安装方式、收费与平台支持等信息。