create-branch

create-branch

热门

创建一个遵循 Sentry 命名约定的 git 分支。当被要求“创建分支”、“新分支”、“开始分支”、“制作分支”、“切换到新分支”或开始在默认分支上进行新工作时使用。

883Star
45Fork
更新于 2026/7/23
SKILL.md
只读
名称
create-branch
描述

创建一个遵循 Sentry 命名约定的 git 分支。当被要求“创建分支”、“新分支”、“开始分支”、“制作分支”、“切换到新分支”或开始在默认分支上进行新工作时使用。

创建分支

创建一个遵循 Sentry 命名约定的 git 分支。
除非用户明确要求手动选择名称,否则保持此工作流非交互式。

工作流

  1. 解析工作描述:

    • 如果提供了 $ARGUMENTS,则使用它
    • 否则检查:
      git diff
      git diff --cached
      git status --short
      
    • 如果有本地更改,则从差异中派生简短描述
    • 如果没有本地更改,则使用通用描述,如 repo-maintenancetooling-updatework-in-progress
  2. 分类分支类型:

类型 使用场景
feat 新功能
fix 修复了损坏的行为
ref 行为不变,结构变化
chore 维护现有工具/配置
perf 行为相同,速度更快
style 仅视觉或格式
docs 仅文档
test 仅测试
ci CI/CD 配置
build 构建系统
meta 仓库元数据
license 许可证更改

不确定时:新事物使用 feat,重构使用 ref,维护使用 chore

  1. 生成 <type>/<short-description>
    保持 <short-description> 为 kebab-case,仅 ASCII,理想情况下 3 到 6 个单词。

  2. 无需提示选择基础分支:

    git branch --show-current
    git remote | grep -qx origin && echo origin || git remote | head -1
    git symbolic-ref refs/remotes/<remote>/HEAD 2>/dev/null | sed 's|refs/remotes/<remote>/||' | tr -d '[:space:]'
    
    • 如果默认分支检测失败,则回退到 main,然后 master,最后当前分支
    • 如果在分离的 HEAD 上,则从当前提交创建分支
    • 如果已经在非默认分支上,则从当前分支创建分支
    • 仅当用户明确要求时才切换到默认分支
  3. 通过追加 -2-3 等避免冲突,直到名称在本地和远程均未使用。

  4. 创建分支:

    git checkout -b <branch-name>
    

    报告最终的分支名称,但不要停下来等待确认。

参考