用途:在提交代码时自动生成符合 Conventional Commits 规范的提交信息。当用户执行不带信息的 git commit、已暂存改动、询问提交信息怎么写,或提到 commit/conventional commits 时激活。
主要能力:分析暂存差异并生成 <type>(<scope>): <subject> 格式信息。支持类型 feat、fix、docs、style、refactor、perf、test、build、ci、chore;主题行不超过 50 字符、使用祈使语气、结尾不加句号;正文说明 WHAT 与 WHY、按 72 字符换行、可用要点列出多项改动;页脚支持 BREAKING CHANGE 与 Closes/Fixes 引用 issue。
使用方式:先执行 git diff --staged --name-only 与 git diff --staged 查看暂存内容,再按新增文件、修改文件、删除文件、测试文件、文档等归类,分析改动内容、原因、影响及是否含破坏性变更,最后生成信息。可与 prepare-commit-msg 钩子配合,在未提供提交信息时写入建议;也可用 git commit --amend 改进已有信息。
适用场景:前端、后端、基础设施等各类改动的提交信息撰写,支持自定义类型(如 deploy、migrate、hotfix)、自定义 scope 与团队模板(如加 JIRA 编号)。
限制:资料未提供具体安装命令、价格、平台支持范围与效果数据;沙箱环境下可选网络访问 api.github.com 以获取或校验 issue 信息,非必需。