用途:为代码变更生成简洁精确的提交信息,采用 Conventional Commits 格式,强调写清“为什么”而非“做了什么”,去除冗余表达。
主要能力与规则:主题行格式为 <type>(<scope>): <imperative summary>,scope 可选。类型包括 feat、fix、refactor、perf、docs、test、chore、build、ci、style、revert。使用祈使语气如 add、fix、remove,而非 added、adds、adding。主题行尽量不超过 50 字符,硬上限 72,结尾不加句号。
正文仅在必要时添加:非显而易见的 why、破坏性变更、迁移说明、关联 issue。正文按 72 字符换行,使用 - 而非 * 作项目符号,末尾引用 issue/PR,如 Closes #42、Refs #17。
禁止内容:"This commit does X"、"I"、"we"、"now"、"currently" 等冗余表述;"As requested by..." 应改用 Co-authored-by trailer;除非用户自有规则要求,否则不添加 AI 署名;除非项目约定,不用 emoji;不在 scope 已表明时重复文件名。
自动澄清:破坏性变更、安全修复、数据迁移、回滚先前提交必须写正文,不得压缩为仅主题行。破坏性变更用 ! 标记并附 BREAKING CHANGE 说明。
边界:仅生成提交信息,不运行 git commit、不暂存文件、不 amend。输出为可直接粘贴的代码块。说 "stop caveman-commit" 或 "normal mode" 可恢复详细提交风格。