create-branch

name	create-branch
description	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.
disable-model-invocation	true

Create Branch

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

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

对外文案（硬性）

最终对外产物必须干净，不是「自己别主动写」。本环境跑 git commit 会自动注入 Co-authored-by: Cursor <[e-mail]>；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）。

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

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

4. git add .

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

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）：

.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