关于 piv-commit
piv-commit 是用于提交仓库所有未提交变更的开发技能。它先检查项目的提交规范,再创建一个带描述性 Conventional Commit 风格消息的原子提交。
主要功能
- 01检查项目提交规范
- 02查看未提交的变更
- 03暂存已变更和未跟踪文件
- 04创建带类型标签的原子提交
- 05汇总已提交的变更
适用场景
- 01提交一组本地变更
- 02遵循仓库专属的提交规则
- 03用简洁摘要记录开发工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ coleam00/ skills --skill piv-commit安装后在 Claude Code 中输入/piv-commit确认已加载。
详细介绍
提交:创建新提交
为所有未提交的更改创建一个新提交。
流程
- 阅读本项目的约定。 如果
.claude/references/conventions.md存在,请阅读其## commit部分并遵循其中的规则——这些规则优先于以下默认规则。项目特定的要求都记录在该文件中;此技能保持通用。 - 运行
git status && git diff HEAD && git status --porcelain,查看有哪些文件尚未提交。 - 添加未跟踪和已更改的文件。
- 编写一条原子化的提交消息,并附上恰当且清晰的摘要。
- 添加一个能反映所做工作的标签,例如
feat、fix、docs、refactor、test、chore等。
输出
一个包含所有未提交更改的提交,并使用符合 Conventional Commits 风格的消息
(<tag>: <atomic description>),准确反映完成的工作。
提交成功后,打印两个带有明确标题的摘要:
更改内容
用一段简短的文字(3–6 句)描述已提交的功能、修复或重构——说明它解决的问题以及涉及的关键文件,方便开发者快速浏览 git 日志。
AI 层更改
仅当 .claude/ 下的文件有修改或新增时,才包含此部分(例如 CLAUDE.md、.claude/references/、.claude/skills/、.claude/agents/ 等)。
列出每个更改过的 AI 层文件,并用一句话说明其更新内容及原因。如果 .claude/ 中没有任何更改,则完全省略此部分。
评论
支持 Markdown