用途:为 Git 未提交改动生成中文 Conventional Commits 风格提交说明,并按用户确认执行提交。
主要能力:检查未提交改动(优先读 staged diff,无 staged 时读 working tree diff,并说明来源);选择单一最贴切的 type;选择简短可检索的 scope;标题格式为 type(scope): 中文概述,如 feat(crm): 添加自建SCRM平台集成支持;变更超过一个要点时用空行加 - 开头的中文正文列表;破坏性变更写 BREAKING CHANGE: 并说明迁移动作。支持类型包括 feat、fix、refactor、perf、chore、config、docs、test、build。scope 优先用业务域、功能域、技术域或主要类名,不使用 project、code、java 等过大范围,也不堆叠多个 scope。
使用方式:先读取所有未提交代码判断主要改动主题,直接产出一版完整提交文档,不先反问;随后附一句确认,如“是否按这版提交?”。用户回答确认、提交、可以、就这样时,用该文案执行 git commit;用户明确修改标题或正文时视为覆写文案,复述或直接采用用户版本,只再做一次确认,第二次确认后执行 git commit。执行提交优先用非交互方式传入完整文案,避免打开编辑器,并保留标题与正文多行格式。
限制:当前目录不是 git 仓库、没有未提交改动或 git commit 失败时,直接说明具体原因,不虚构结果;执行前不得声称已提交。标题不使用 修改docker、111、init、refeat 等不可检索表述,不加 Markdown 标记,提交说明默认不包进代码块。若项目现有风格与本规范冲突,优先沿用仓库最近的高质量提交风格并说明取舍。