mcpField
G
git-branch-format

git-branch-format

github.com/somnio-software开发8116 次安装6 天前更新
代码仓库

关于 git-branch-format

git-branch-format 是一项根据变更描述生成 Git 分支名的技能。它会判断分支类型,并按 snake_case 规则格式化描述,可选加入工单编号。

主要功能

  1. 01根据变更推断分支类型
  2. 02将描述格式化为 snake_case
  3. 03支持可选工单编号
  4. 04描述最多使用三个词

适用场景

  1. 01为新功能命名分支
  2. 02生成缺陷修复分支名
  3. 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性能改进
ciCI/CD 变更
build构建系统变更
revert撤销之前的提交

工作流

  1. 阅读用户的变更描述。
  2. 询问:“有工单编号吗?” — 如果用户没有提供,就不带工单编号继续操作。
  3. 根据变更性质推断正确的 type。
  4. 按照上述约定生成分支名称。

示例

用户:“我正在添加深色模式支持” — 工单:PROJ-312

feat/PROJ-312_dark_mode_support

用户:“修复付款页面上的崩溃问题” — 无工单

fix/payment_screen_crash

用户:“升级 Flutter 并修复已弃用的 API” — 工单:PROJ-548

feat/PROJ-548_flutter_upgrade

评论

支持 Markdown