mcpField
C
commit

commit

github.com/helderberto开发2059 次安装1 周前更新
代码仓库

关于 commit

用于规范 Git 提交流程的开发技能,指导开发者按逻辑拆分变更、遵循仓库现有提交信息风格并确认工作区状态。它限制提交范围,并明确不执行推送。

主要功能

  1. 01按逻辑问题拆分原子提交
  2. 02参考仓库近期提交风格
  3. 03按指定路径限制提交范围
  4. 04显式暂存并逐次确认状态
  5. 05钩子失败时创建新提交

适用场景

  1. 01提交包含多个改动主题的工作
  2. 02仅提交指定路径中的变更
  3. 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)。

工作流

  1. 检查完整差异和状态;查看近期日志,了解提交风格。
  2. 识别逻辑分组:功能/修复、对应测试、配置、纯格式调整、文档、资源。
  3. 对每个分组:按名称显式暂存这些文件,使用 HEREDOC 消息提交,并在处理下一个分组前确认 git status。
  4. 最后确保工作树干净(限定范围运行时:所有列出的文件都已提交)。如果不确定如何分组某个文件,请询问。

分组规则

  • 纯格式调整(空格、引号、缩进)单独提交,与逻辑更改分开。
  • 同一文件同时包含逻辑更改和格式调整时,归入逻辑提交。
  • 测试及其测试的代码可以放在同一个提交中。
  • 如果提交前钩子失败,请修复、重新暂存,并创建新提交;绝不使用 --amend,也不跳过钩子。

评论

支持 Markdown