mcpField
C
commit

commit

github.com/paulnsorensen开发141 次安装1 天前更新
代码仓库

关于 commit

用于选择文件暂存并创建 Conventional Commit 的 Git 技能,不会推送更改。它涵盖从检查差异和历史记录,到提交并验证仓库状态的流程。

主要功能

  1. 01检查状态、差异和近期历史
  2. 02按文件名暂存
  3. 03编写 Conventional Commit 消息
  4. 04提交并验证仓库状态

适用场景

  1. 01审查更改后创建提交
  2. 02避免将无关文件纳入提交
  3. 03提交后核对仓库状态

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/paulnsorensen/skillz-that-grillz --skill commit

安装后在 Claude Code 中输入/commit确认已加载。

详细介绍

commit

暂存并提交。使用 Conventional Commits。不要推送。

协议

首先并行运行:

git status
git diff HEAD
git log --oneline -5

然后按顺序执行:

  1. 了解原因 — 阅读差异,了解改动内容及原因
  2. 暂存指定文件 — 按名称指定,绝不使用 git add -A 或 git add .
  3. 起草提交信息 — 参见下方格式
  4. 通过 heredoc 提交(保留格式)
  5. 使用 git status 验证

提交信息格式

type(scope): short description (≤72 chars)

Optional body if nuance is lost without it.

Co-Authored-By: <agent-name> <agent-email>

Co-Authored-By 附加行是可选的——填写运行环境提供的 Agent 身份;如果项目不需要,也可以完全省略这一行。

类型:feat、fix、refactor、chore、docs、test、style

着重说明原因,而不是内容。差异已经展示了改动内容。

使用 heredoc 保留格式:

git commit -m "$(cat <<'EOF'
type(scope): short description

Co-Authored-By: <agent-name> <agent-email>
EOF
)"

规则

  • 除非明确要求,否则绝不 amend——改为创建新提交
  • 绝不使用 --no-verify——不要跳过钩子
  • 绝不强制推送到 main/master
  • 不推送、不创建 PR——将这部分交给 gh 技能处理
  • **钩子失败?**修复问题、重新暂存,并创建新提交(不要 amend)
  • 不要提交 .env、凭据或大型二进制文件——提醒用户

注意事项

  • 提交信息中的 heredoc 如果包含反引号或 $,需要使用单引号分隔符(<<'EOF',而不是 <<EOF)
  • 如果 prek 钩子失败,提交就没有完成——修复后创建新提交,绝不要 amend
  • Co-Authored-By 附加行是可选的——使用运行环境提供的 Agent 身份;如果项目不记录 Agent 作者信息,则省略这一行
  • 暂存后 git diff HEAD 为空,表示没有添加新内容——请改为检查 git diff --cached

评论

支持 Markdown