关于 git-branch-format
git-branch-format 是一项根据变更描述生成 Git 分支名的技能。它会判断分支类型,并按 snake_case 规则格式化描述,可选加入工单编号。
主要功能
- 01根据变更推断分支类型
- 02将描述格式化为 snake_case
- 03支持可选工单编号
- 04描述最多使用三个词
适用场景
- 01为新功能命名分支
- 02生成缺陷修复分支名
- 03创建关联工单的分支名
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ somnio-software/ somnio-ai-tools --skill git-branch-format安装后在 Claude Code 中输入/git-branch-format确认已加载。
详细介绍
Git 分支格式技能
根据变更描述生成分支名称。
约定
带工单编号
{type}/{TICKET_NUMBER}_{short_description}
TICKET_NUMBER使用用户提供的大写格式(例如PROJ-548)short_description使用snake_case,最多 3 个单词 — 建议 1–2 个- 示例:
feat/TICKET-548_flutter_upgrade
不带工单编号
{type}/{short_description}
short_description使用snake_case,最多 3 个单词 — 建议 1–2 个- 示例:
feat/flutter_upgrade
切勿使用 NO-TICKET 之类的占位符。如果没有工单,就完全省略这部分。
类型选择指南
| 类型 | 使用场景 |
|---|---|
feat | 新功能 |
fix | 修复错误 |
refactor | 不改变行为的代码变更 |
chore | 配置、依赖、工具或维护 |
test | 添加或更新测试 |
docs | 仅修改文档 |
style | 格式调整、空白字符 |
perf | 性能改进 |
ci | CI/CD 变更 |
build | 构建系统变更 |
revert | 撤销之前的提交 |
工作流
- 阅读用户的变更描述。
- 询问:“有工单编号吗?” — 如果用户没有提供,就不带工单编号继续操作。
- 根据变更性质推断正确的
type。 - 按照上述约定生成分支名称。
示例
用户:“我正在添加深色模式支持” — 工单:PROJ-312
feat/PROJ-312_dark_mode_support
用户:“修复付款页面上的崩溃问题” — 无工单
fix/payment_screen_crash
用户:“升级 Flutter 并修复已弃用的 API” — 工单:PROJ-548
feat/PROJ-548_flutter_upgrade
评论
支持 Markdown