关于 committing-changes
用于规范 Git 提交的仓库技能,涵盖分支检查、基于 Jira 工单的提交格式和提交前质量门禁,适合遵循项目约定的贡献者。
主要功能
- 01检查远程默认分支
- 02默认分支提交前要求指定分支
- 03初次提交包含 Jira 工单和类型
- 04后续提交可使用简短说明
- 05暂存前运行预检
适用场景
- 01避免直接提交到默认分支
- 02按 Jira 工单约定编写提交
- 03暂存前检查测试、Lint、安全和架构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bitwarden/ ai-plugins --skill committing-changes安装后在 Claude Code 中输入/committing-changes确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/baseline.jsonbehavior-baseline.jsonbehavior-eval.jsonREADME.mdrun_real_eval.pytrigger-eval.json详细介绍
Git 提交规范
分支检查
从远程仓库解析仓库的默认分支,而不是假定默认分支为 main。如果当前分支是默认分支,请在暂存或提交之前询问分支名称。可以提出建议,并在切换分支前确认。如果无法解析默认分支,请说明这一点,并在暂存前确认是否有意使用当前分支。
提交消息格式
[PM-XXXXX] <type>: <imperative summary>
<optional body explaining why, not what>
规则
- 工单前缀:始终包含与 Jira 工单匹配的
[PM-XXXXX] - 类型关键词:调用
Skill(labeling-changes)来选择约定式提交类型。
示例
[PM-12345] feat: Add biometric unlock timeout configuration
Users reported confusion about when biometric prompts appear.
This adds a configurable timeout setting to the security preferences.
模糊情况 — 在相似类型之间做出选择:
# Refactor that also fixes a bug? Use the primary intent:
[PM-12345] fix: Resolve null pointer in vault sync retry logic
# Test-only change:
[PM-12345] test: Add unit tests for biometric timeout edge cases
后续提交
分支上的第一个提交需要完整格式(工单前缀、类型关键词、正文)。后续提交可以使用简短且描述性强的摘要,无需前缀或正文。
Update error handling in login flow
提交前质量门禁
暂存前,运行 perform-preflight 技能,执行完整的质量门禁检查清单(测试、lint、安全、架构)。查阅仓库的 CLAUDE.md,了解特定平台的构建和 lint 命令。
评论
支持 Markdown