用途:生成精简、准确的 Git 提交信息,采用 Conventional Commits 格式,强调“为什么”而非“做了什么”。
主要能力:主题行格式为 <type>(<scope>): <imperative summary>,scope 可选;type 支持 feat、fix、refactor、perf、docs、test、chore、build、ci、style、revert;使用祈使语气(add、fix、remove);尽量不超过 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 尾注);AI 归因(除非用户自有规则要求 Assisted-by 尾注);emoji(除非项目约定要求);scope 已含文件名时的重复。
自动清晰规则:破坏性变更、安全修复、数据迁移、回滚此前提交,必须保留正文,不压缩为仅主题。
使用方式:仅生成提交信息,不执行 git commit、不暂存文件、不 amend;输出为可直接粘贴的代码块。输入“stop caveman-commit”或“normal mode”可恢复冗长提交风格。
适用场景与限制:适合希望提交历史简洁、规范且可追溯的项目;限制为不代替 git 操作,不判断实际代码改动。其余细节资料未提供。