用途:生成极简、精确的提交信息,采用 Conventional Commits 格式,强调“为什么”而非“做了什么”。
主要能力:主题行格式为 <type>(<scope>): <imperative summary>,scope 可选;类型包括 feat、fix、refactor、perf、docs、test、chore、build、ci、style、revert;使用祈使语气,尽量不超过 50 字符,硬上限 72 字符,不加句号。正文仅在需要时添加,用于非显而易见的 why、破坏性变更、迁移说明、关联 issue;正文按 72 字符换行,用 - 而非 *,末尾引用 issue/PR,如 Closes #42、Refs #17。禁止出现“This commit does X”“I”“we”“now”“currently”、AI 署名、emoji(除非项目约定要求)等。
使用方式:仅生成提交信息,不执行 git commit、不暂存文件、不 amend;输出为可直接粘贴的代码块。输入“stop caveman-commit”或“normal mode”可恢复详细提交风格。
适用场景:需要快速产出规范、无噪音的提交信息,尤其适合重视提交历史可读性的项目。
限制:不自动执行 git 操作;破坏性变更、安全修复、数据迁移、回滚提交必须包含正文,不可压缩为仅主题行。资料还描述了任务完成后向 wiki 写入 propose 草稿的步骤,包括按 DDMMYY-<ten>.md 命名、更新 index.md 与 log.md;纯展示模式(如 /caveman-stats)可跳过。