用途
该技能用于在 Git 仓库中为指定的功能规格创建并切换到一个新的功能分支。它只处理分支创建这一环节,不会生成规格目录或文件,这些由核心 /speckit-specify 工作流负责。
主要能力
- 支持两种分支编号模式:顺序编号(如 003-user-auth)和时间戳编号(如 20260319-143022-user-auth)。
- 支持通过 GIT_BRANCH_NAME 环境变量指定精确分支名,此时脚本直接使用该值,忽略 --short-name、--number、--timestamp 标志;若名称以数字前缀开头,则从中提取 FEATURE_NUM,否则 FEATURE_NUM 设为完整分支名。
- 自动生成 2-4 个词的简短分支名,尽量采用“动作-名词”格式,并保留技术术语与缩写(如 OAuth2、API、JWT)。
- 输出 JSON,包含 BRANCH_NAME 和 FEATURE_NUM,便于调用方解析。
- 具备优雅降级:若 Git 不可用或当前目录不是 Git 仓库,则跳过分支创建并输出警告,但仍返回 BRANCH_NAME 和 FEATURE_NUM。
使用方式
- 确认 Git 可用:运行 git rev-parse --is-inside-work-tree 2>/dev/null,若不可用则警告并跳过分支创建。
- 确定分支编号模式:依次检查 .specify/extensions/git/git-config.yml 中的 branch_numbering 值,再检查 .specify/init-options.json 中的 branch_numbering 值,若都不存在则默认使用顺序编号。
- 根据功能描述生成简洁短名(2-4 个词)。
- 根据平台运行对应脚本:
- Bash:.specify/extensions/git/scripts/bash/create-new-feature.sh --json --short-name "<short-name>" "<feature description>"
- Bash(时间戳):.specify/extensions/git/scripts/bash/create-new-feature.sh --json --timestamp --short-name "<short-name>" "<feature description>"
- PowerShell:.specify/extensions/git/scripts/powershell/create-new-feature.ps1 -Json -ShortName "<short-name>" "<feature description>"
- PowerShell(时间戳):.specify/extensions/git/scripts/powershell/create-new-feature.ps1 -Json -Timestamp -ShortName "<short-name>" "<feature description>"
- 注意:不要传入 --number,脚本会自动确定下一个编号;始终包含 JSON 标志;每个功能只运行一次该脚本。
适用场景
适用于使用 Git 进行版本控制、并配合 spekit 规格工作流开发功能的团队或个人,在开始新功能开发前快速创建规范命名的功能分支。
限制
- 仅负责分支创建,不创建规格目录或文件。
- 依赖 Git 环境;非 Git 仓库中会跳过创建。
- 需要存在相应的脚本文件(create-new-feature.sh 或 create-new-feature.ps1)。
- 分支编号模式配置需位于指定路径。
- 具体脚本行为细节、错误处理与平台兼容性暂未提供更多说明。