用途:为 Git 提交生成符合 Conventional Commits 格式的信息,并尽量匹配当前仓库的语言与约定。
主要能力:格式为 type(scope): description,可带可选正文与页脚。工作流包括运行 git diff --staged 查看暂存改动、运行 git log --oneline -10 检查仓库风格、从最近提交检测语言、检测页脚模式(如 Change-Id、工单号)、根据改动选择提交类型、从受影响文件推断 scope、撰写简短描述。语言检测依据最近 10 条提交的主导语言,例如波兰语或英语。
原子提交:一次提交对应一个逻辑变更。若改动需要不同类型(如 feat 与 fix),应拆分为多个提交。判断标准是能否用一行主题描述而不使用 and。
风格规则:使用祈使语气,结尾不加句号,正文不用破折号,主题控制在 50 字符以内,匹配仓库语言与约定。写作尽量简洁,主题尽可能短,不用填充词,正文不用项目符号,除非必要否则省略正文。正文仅在需要解释原因时使用,用散文式 1 至 2 句,说明为什么而非做了什么。
破坏性变更:在类型或 scope 后加感叹号,或使用 BREAKING CHANGE 页脚。页脚从仓库历史检测,如 Change-Id、工单 ID、Signed-off-by,不要添加仓库未使用的页脚。
安全:先检查 git status,绝不提交密钥,提交前确认暂存文件。类型细节可参考 quick-reference.md。
限制:资料未提供安装方式、收费、平台支持及具体效果等信息。