caveman-commit 的用途是生成极简、准确的提交信息,遵循 Conventional Commits 格式,强调“为什么”而非“做了什么”。
主要能力与规则:主题行格式为 <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”(diff 已说明做了什么);不写“As requested by...”(用 Co-authored-by trailer);绝不添加“Generated with Claude Code”等 AI 署名;不用 emoji(除非项目惯例要求);scope 已含文件名时不重复。
强制清晰场景:破坏性变更、安全修复、数据迁移、回滚先前提交时必须写正文,不可压缩为主题单行。示例:破坏性变更使用 feat(api)!: rename /v1/orders 至 /v1/checkout,并以 BREAKING CHANGE 说明迁移截止时间。
使用方式与限制:该技能只生成提交信息,不执行 git commit、不暂存文件、不 amend;输出为可直接粘贴的代码块。输入“stop caveman-commit”或“normal mode”可恢复详细提交风格。未提供安装命令、平台支持与费用信息。