关于 commit
用于选择文件暂存并创建 Conventional Commit 的 Git 技能,不会推送更改。它涵盖从检查差异和历史记录,到提交并验证仓库状态的流程。
主要功能
- 01检查状态、差异和近期历史
- 02按文件名暂存
- 03编写 Conventional Commit 消息
- 04提交并验证仓库状态
适用场景
- 01审查更改后创建提交
- 02避免将无关文件纳入提交
- 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
然后按顺序执行:
- 了解原因 — 阅读差异,了解改动内容及原因
- 暂存指定文件 — 按名称指定,绝不使用
git add -A或git add . - 起草提交信息 — 参见下方格式
- 通过 heredoc 提交(保留格式)
- 使用
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