关于 commit
用于规范 Git 提交流程的开发技能,指导开发者按逻辑拆分变更、遵循仓库现有提交信息风格并确认工作区状态。它限制提交范围,并明确不执行推送。
主要功能
- 01按逻辑问题拆分原子提交
- 02参考仓库近期提交风格
- 03按指定路径限制提交范围
- 04显式暂存并逐次确认状态
- 05钩子失败时创建新提交
适用场景
- 01提交包含多个改动主题的工作
- 02仅提交指定路径中的变更
- 03按项目惯例撰写简短提交信息
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ helderberto/ agent-skills --skill commit安装后在 Claude Code 中输入/commit确认已加载。
详细介绍
Git 提交
将所有未暂存和未跟踪的更改分组为原子提交——每个逻辑事项一个提交。只有一个事项的情况就是特例:提交一个。绝不推送——推送属于 /hb:to-pr。
$ARGUMENTS 中的路径限定本次运行范围:只提交这些文件,其余文件保持原样。
提交消息风格
参照仓库中 git log 的现有提交模式。极致简洁——必要时牺牲语法。重点说明“为什么”,而非“做了什么”。使用祈使语气。若仓库使用 Conventional Commits,则使用带作用域的提交类型(feat/fix/refactor/docs/chore)。
工作流
- 检查完整差异和状态;查看近期日志,了解提交风格。
- 识别逻辑分组:功能/修复、对应测试、配置、纯格式调整、文档、资源。
- 对每个分组:按名称显式暂存这些文件,使用 HEREDOC 消息提交,并在处理下一个分组前确认
git status。 - 最后确保工作树干净(限定范围运行时:所有列出的文件都已提交)。如果不确定如何分组某个文件,请询问。
分组规则
- 纯格式调整(空格、引号、缩进)单独提交,与逻辑更改分开。
- 同一文件同时包含逻辑更改和格式调整时,归入逻辑提交。
- 测试及其测试的代码可以放在同一个提交中。
- 如果提交前钩子失败,请修复、重新暂存,并创建新提交;绝不使用
--amend,也不跳过钩子。
评论
支持 Markdown