用途:在暂存和提交代码、撰写提交信息、修改上一条提交(amend)等场景下提供规范做法,帮助写出意图清晰、粒度合理的原子提交。
主要能力:提供决策流程,区分“暂存并提交”“amend 上一条提交”“仅写提交信息”“钩子失败”四类需求;给出 Conventional Commits 格式(<type>(<scope>): <subject>)与类型表,涵盖 feat、fix、refactor、docs、test、chore、perf、ci;说明主题行不超过 72 字符、使用祈使语气、不加句号,正文按 72 字符换行并侧重动机,破坏性变更用 BREAKING CHANGE 页脚或类型后加 !。
用法:先运行 git status 与 git diff --staged 查看变更,把相关改动归为一个逻辑单元再提交;amend 仅用于尚未推送到远端的场景(如漏文件、改信息),已推送或改动较大时应新建提交。提交前检查是否含密钥、调试代码、临时 hack,改动是否相关,.gitignore 是否生效。钩子失败时读取完整输出、修复根因、重新暂存并新建提交,除非用户明确要求否则不要使用 --no-verify。
安装:npx skills add -g onsager-ai/dev-skills --skill git-commit -a claude-code -y。
适用场景:日常代码提交、提交信息撰写、提交历史整理。限制:具体钩子配置、团队自定义规范等资料未提供;不应提交 WIP 或含糊的 “misc fixes”,需提交前拆分或压缩。