用途:在创建提交时生成符合 Conventional Commits 的提交信息,并根据仓库已有风格进行调整。
主要能力:按 type(scope): description 结构生成信息;通过 git diff --staged 查看暂存变更,通过 git log --oneline -10 检查仓库风格;从最近提交中识别语言(如英语 Add/Fix 或波兰语 Dodanie/Naprawa)并匹配主导语言;识别 footer 模式(如 Gerrit 的 Change-Id、JIRA 工单号、Signed-off-by);根据变更选择类型、从受影响文件推断 scope、编写简短描述。
原子提交:一次提交只对应一个逻辑变更。若变更需要不同类型(如 feat 与 fix 混在一起),应拆分为多个提交。规则是判断能否用一行主题不带“and”描述清楚。
风格要求:使用祈使语气(add 而非 added);结尾不加句号;正文不用长破折号;主题尽量少于 50 字符;匹配仓库语言与约定。写作尽量简洁,正文非必要不写,正文只用散文不用项目符号,解释“为什么”而非“做了什么”,每个逻辑变更一句。
破坏性变更:在类型或 scope 后加感叹号(如 feat!: 或 feat(api)!:),或使用 BREAKING CHANGE footer。
Footer:依据仓库历史决定是否添加,不要添加仓库未使用的 footer。
安全:提交前检查 git status,绝不提交密钥,提交前核验暂存文件。
限制:技能内容基于给定资料,未提供具体安装命令、收费方式或平台支持信息;类型细节可参考其 quick-reference.md。