SKILL.md
只读
名称
create-branch
描述
创建一个遵循 Sentry 命名约定的 git 分支。当被要求“创建分支”、“新分支”、“开始分支”、“制作分支”、“切换到新分支”或开始在默认分支上进行新工作时使用。
创建分支
创建一个遵循 Sentry 命名约定的 git 分支。
除非用户明确要求手动选择名称,否则保持此工作流非交互式。
工作流
-
解析工作描述:
- 如果提供了
$ARGUMENTS,则使用它 - 否则检查:
git diff git diff --cached git status --short - 如果有本地更改,则从差异中派生简短描述
- 如果没有本地更改,则使用通用描述,如
repo-maintenance、tooling-update或work-in-progress
- 如果提供了
-
分类分支类型:
| 类型 | 使用场景 |
|---|---|
feat |
新功能 |
fix |
修复了损坏的行为 |
ref |
行为不变,结构变化 |
chore |
维护现有工具/配置 |
perf |
行为相同,速度更快 |
style |
仅视觉或格式 |
docs |
仅文档 |
test |
仅测试 |
ci |
CI/CD 配置 |
build |
构建系统 |
meta |
仓库元数据 |
license |
许可证更改 |
不确定时:新事物使用 feat,重构使用 ref,维护使用 chore。
-
生成
<type>/<short-description>。
保持<short-description>为 kebab-case,仅 ASCII,理想情况下 3 到 6 个单词。 -
无需提示选择基础分支:
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 上,则从当前提交创建分支
- 如果已经在非默认分支上,则从当前分支创建分支
- 仅当用户明确要求时才切换到默认分支
- 如果默认分支检测失败,则回退到
-
通过追加
-2、-3等避免冲突,直到名称在本地和远程均未使用。 -
创建分支:
git checkout -b <branch-name>报告最终的分支名称,但不要停下来等待确认。






