# Create Branch

> Create a feature branch from staged working-tree changes, switch to it, run git add ., and commit. Use when the user asks to create a branch, switch branch from staged changes, commit staged work, run this skill, or invoke create-branch. Does not push or open a PR.

- Skill: `emiyaaaaa/create-branch` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add emiyaaaaa/create-branch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/emiyaaaaa/create-branch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: emiyaaaaa (https://skillmd.com/u/emiyaaaaa)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/emiyaaaaa/create-branch

---


# Create Branch

根据暂存区的代码内容生成分支名并切分支，把暂存区的代码执行git add . 然后commit。

不 push、不开 PR。开 PR 走 `create-pr` skill。

## 对外文案（硬性）

**最终对外产物必须干净**，不是「自己别主动写」。本环境跑 `git commit` 会自动注入 `Co-authored-by: Cursor <cursoragent@cursor.com>`；soft reset 后再 `git commit` 仍会注入。

因此：**禁止 `git commit`**。只用 `scripts/commit-index.sh`（内部 `git commit-tree` + `git update-ref`）。写完立刻 `git log -1 --format=%B`；trailer 里还有 cursor 就当失败，不要继续。

Commit subject/body、分支名 **都不能带有任何 cursor 相关的字样**（大小写均禁），包括：`Cursor`、`cursor`、`.cursor`、`cursor.com`、Cursor Agent、Made with Cursor、Generated by Cursor、`Co-authored-by: Cursor`。

改动若是仓库 agent skill，对外只写 skill 名（如 `create-pr`），不要写工具目录路径。

## 何时执行

仅在用户显式要求切分支、从暂存区建分支、提交暂存改动、执行本 skill 时运行。不要在创建 PR、闲聊、或无关编辑后主动执行。

## 工作流

按顺序执行。任一步失败则停下，不要 commit。

```
- [ ] 1. 收集暂存区 / 工作区改动
- [ ] 2. 预检（无改动 / 机密文件）
- [ ] 3. 根据暂存区内容生成分支名并切分支
- [ ] 4. git add .
- [ ] 5. 根据暂存区内容生成 commit message，用 `commit-index.sh`（commit-tree）提交
- [ ] 6. `git log -1 --format=%B` 确认无 cursor trailer
- [ ] 7. 把分支名和 commit 回给用户
```

### 1. 收集改动

从仓库根目录执行 `.cursor/skills/create-branch/scripts/collect-changes.sh`。它会打印：

- 当前分支、默认 base、`on_default`
- `has_staged` / `has_unstaged`
- **staged (index)**：暂存区 diff（命名与 commit 的主依据）
- unstaged / untracked：随后 `git add .` 也会纳入，生成名字时一并考虑

不要打印带凭据的 remote URL。

### 2. 预检

| 情况 | 动作 |
|------|------|
| `has_staged: false` 且 `has_unstaged: false` | 停止。没有可提交的改动。 |
| `has_staged: false` 但工作区有改动 | 继续。用 unstaged / untracked 生成分支名；下一步 `git add .` 会把它们送进暂存区。 |
| 改动里有 `.env`、`credentials.json`、私钥、或其它机密 | 停止并指出路径。不要 `git add .`，不要 commit。 |
| detached HEAD | 脚本会失败。停下。 |

禁止：`git commit`（会注入 Cursor trailer）、改 git config、`--force`、`--amend`、interactive rebase、push、`gh pr create`、reset 默认分支。

### 3. 生成分支名并切分支

根据暂存区的代码内容生成分支名并切分支。以 staged diff 为主；暂存区为空时用 unstaged + untracked。不要问用户要名字，除非脚本因重名失败。

**命名规则**（对齐本仓库：`feat/openapi-sdk`、`fix/run-message-pagination`）：

- `{type}/{kebab-slug}`。`type` 按改动推断（`feat` / `fix` / `docs` / `chore` / `refactor` / `perf` / `test` / `ci`），默认 `feat`。
- `slug`：2–5 个英文词，来自改动意图（diff 内容 + 主要路径），全小写、连字符、ASCII。**slug 里不得出现 `cursor`。**
- 总长 ≤ 50。不要用日期、username、随机 hash 当主体。
- 禁止：`main` / `master` / `HEAD` / 默认分支名。本地或 `origin/` 已存在则在 slug 末尾加 `-2`（再冲突 `-3`）。

示例：暂存区是 create-pr skill 的新增文件 → `feat/create-pr-skill`。

无论当前是否在默认分支，都切到新分支（`git switch -c` 会带走暂存区和工作区改动；旧分支停在原 HEAD）。

```bash
.cursor/skills/create-branch/scripts/create-and-switch.sh "${BRANCH}"
```

失败则贴错误并停下。不要 checkout 回默认分支，不要 reset。切完后确认当前分支已不是 `main` / `master`，**然后才允许 add / commit**。绝对不要在默认分支上 commit。

### 4. git add .

把暂存区的代码执行git add . 然后commit。本步只做 add：

```bash
git add .
```

`git add .` 之后立刻 `git diff --cached --name-only`。若出现机密文件，`git restore --staged` 掉它们并停止，不要 commit。若 add 完暂存区仍为空，停止。

### 5. commit（必须用 commit-tree）

只根据暂存区 diff 生成英文 Conventional Commit，不要编造未出现的功能或文件。

**Language: English only.** Subject 即使源 diff / 路径是中文也要翻译。

- 一行 subject：`feat:` / `fix:` / `docs:` 等前缀 + 祈使句，≤72 字符，句末无句号。
- 需要时再加空行和 1–3 句 body（意图，不列文件名）。不需要就不写 body。
- 范围跟 diff 走：小修复不要写成巨大 refactor。
- message 本身就不许含 `cursor`。不要自己加 `Co-authored-by`。

**不要** `git commit` / `git commit -m` / `--amend`。用脚本（stdin = message）：

```bash
.cursor/skills/create-branch/scripts/commit-index.sh <<'EOF'
feat: add create-branch skill for staged work

EOF
```

脚本会 `git write-tree` + `git commit-tree` + `git update-ref`，并在提交后检查 `%B`。失败则停下。

### 6. 自检

再跑一次 `git log -1 --format=%B`。看到 `Co-authored-by`、`Cursor`、`cursor.com` 或任何 cursor 字样 → 失败，不要把 SHA 当成功。不要再用 `git commit` 重做。

### 7. 收尾

把新分支名、`git log -1 --oneline`、以及 `git status --short` 发给用户。提醒开 PR 用 `create-pr`。不要 push。

## 示例

Staged: 新增 create-branch skill 的说明与两个脚本。

Branch: `feat/create-branch-skill`

Commit:

```
feat: add create-branch skill for staged work
```