caveman-commit 是一个超精简的提交信息生成器,目标是在保留提交意图与原因的前提下,去掉提交信息中的噪音。它采用 Conventional Commits 格式,强调“为什么”优先于“做了什么”。
用途 用于生成简洁、准确的 Git 提交信息,减少冗余描述,让提交历史更易读。
主要能力
- 主题行格式:<type>(<scope>): <imperative summary>,其中 scope 可选。
- 支持的 type: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);"Generated with Claude Code" 或任何 AI 署名;emoji(除非项目约定要求);当 scope 已说明文件名时重复文件名。
- 自动清晰规则:破坏性变更、安全修复、数据迁移、回滚先前提交,必须包含正文,不得压缩为仅主题行,以便未来调试者获得上下文。
使用方式 该技能只生成提交信息,不运行 git commit、不暂存文件、不执行 amend。输出为可直接粘贴的代码块。可通过“stop caveman-commit”或“normal mode”恢复为详细提交风格。
适用场景 适合希望提交历史简洁、规范、可追溯的开发者与团队,尤其是使用 Conventional Commits 的项目。
限制 仅生成提交信息,不执行任何 Git 操作;不提供收费、价格、平台或效果相关信息(资料未提供)。