用途:分析已暂存的 git 改动并生成描述性提交信息,适合在用户请求撰写提交信息或审查暂存改动时使用。
主要能力:基于 git diff --staged 的输出识别改动类型(feat、fix、docs、style、refactor、test、chore),确定范围,撰写摘要与正文,并标注破坏性变更。遵循 Conventional Commits 格式:<type>(<scope>): <description>,可附可选正文与页脚。
使用方式:先运行 git diff --staged 查看暂存改动,再按模板流程操作:审查改动、识别类型、确定范围、写摘要、加正文、标注破坏性变更。写作要求使用祈使语气、首行不超过 50 字符、首字母大写、摘要末尾不加句号、正文解释原因而非仅描述内容。
适用场景:需要规范化提交信息的日常开发、代码审查前的提交整理、多文件改动或破坏性变更的说明。
限制:资料未提供自动执行提交、与特定平台集成或收费信息;具体命令与示例见其 references/examples.md 和 references/git-commands.md。