create-issue-branch
Create a git branch to start working on a GitHub issue in the torrust-tracker-demo repository. Use when asked to start working on an issue, create a branch for an issue, or check out a new branch. Triggers on "create branch", "new branch", "start working on issue", "branch for issue", "checkout branch".
来源信息
- 仓库
- torrust/torrust-tracker-demo
- 最近来源活动
- 2026年4月13日 11:39
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 2
- 分支
- 1
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- create-issue-branch
- description
- Create a git branch to start working on a GitHub issue in the torrust-tracker-demo repository. Use when asked to start working on an issue, create a branch for an issue, or check out a new branch. Triggers on "create branch", "new branch", "start working on issue", "branch for issue", "checkout branch".
- metadata
- {"author":"torrust","version":"1.0"}
# Creating a Branch for a GitHub Issue
## Branch Naming Convention
```text
<issue-number>-<issue-title-normalized>
```
**Rules**:
- Prefix with the GitHub issue number
- Follow with the issue title, lowercased, spaces replaced by hyphens
- Strip special characters (`:`, `/`, `(`, `)`, etc.)
- No type prefix (`feat/`, `fix/`, etc.)
**Examples**:
| Issue title | Branch name |
| --------------------------------------------------- | ---------------------------------- |
| `feat: document and version-control server config` | `1-document-server-configuration` |
| `fix: UDP tracker down on newTrackon after restart` | `2-udp-tracker-down-on-newtrackon` |
## Workflow
### Step 1 — Confirm the issue number and title
Check the issue draft file (`docs/issues/ISSUE-<N>-*.md`) or the GitHub issue to get the
canonical title. Derive the normalized branch name from it.
### Step 2 — Present the branch name for approval
**Always show the branch name to the user and wait for explicit approval before creating it.**
### Step 3 — Create and switch to the branch locally
Create the branch locally only (do not push to remote at this stage):
```bash
git checkout -b <branch-name>
```
### Step 4 — Push to remote when creating the pull request
The branch is pushed to origin only when creating the pull request. Do not push the branch
to remote immediately after creation—wait until the PR workflow.
在 GitHub 查看