SuperAPI AI 工具集

conventional-branch

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:在新建或命名 Git 分支时,按 Conventional Branch 规范生成一致的分支名,与 Conventional Commits 配套使用。

主要能力:分支名格式为 <type>/<description>。类型包括 feature/(别名 feat/,新功能)、bugfix/(别名 fix/,缺陷修复)、hotfix/(紧急生产修复)、release/(发布准备,版本可含点,如 release/v1.2.0)、chore/(依赖、文档、配置等非代码任务)。main、master、develop 为干线分支,不带前缀,新分支应从其切出而非同名创建。

命名规则:全小写;仅用 a-z、0-9、连字符和点;点只允许出现在 release/ 版本描述中;不使用下划线、空格或特殊字符;禁止连续连字符或点、连字符与点相邻;描述首尾不得有连字符或点。描述建议用 2-5 个词的 kebab-case,简洁明确(总长约 50 字符),如 add-oauth-login、fix-header-overflow;避免 fix-bug、new-feature 这类模糊命名。若涉及 issue 编号可写入描述,如 feature/issue-123-add-oauth。

使用方式(原命令保持原样):

  1. 确定类型,类型不明时默认 feature,并询问简要描述。
  2. 校验名称,修正大写、下划线、空格、连续连字符及首尾符号。
  3. 检测基础分支:

Prefer the remote's default branch

git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's|^origin/||' 若为空,按 develop、main、master 优先级检查本地: for b in develop main master; do git show-ref --verify --quiet "refs/heads/$b" && echo "$b" && break done 4. 创建并切换: git checkout <base> git pull origin <base> git checkout -b <type>/<description> 5. 确认分支名与当前所在分支,并提示就绪后执行 git push -u origin <branch-name>。

适用场景:需要统一团队分支命名、配合 Conventional Commits 提交规范、按类型区分功能/修复/发布/维护分支的仓库。

限制:如何实际执行取决于所用 AI 工具或技能调用方式;本文未提供安装方法、平台要求、收费信息、自动化程度及与各类代码托管平台的兼容性细节,暂未提供。