SuperAPI AI 工具集

speckit-git-feature

编程与开发

查看项目

更新于 10-24 10:10

技能介绍

用途

该技能用于在 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。

使用方式

  1. 确认 Git 可用:运行 git rev-parse --is-inside-work-tree 2>/dev/null,若不可用则警告并跳过分支创建。
  2. 确定分支编号模式:依次检查 .specify/extensions/git/git-config.yml 中的 branch_numbering 值,再检查 .specify/init-options.json 中的 branch_numbering 值,若都不存在则默认使用顺序编号。
  3. 根据功能描述生成简洁短名(2-4 个词)。
  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>"
  5. 注意:不要传入 --number,脚本会自动确定下一个编号;始终包含 JSON 标志;每个功能只运行一次该脚本。

适用场景

适用于使用 Git 进行版本控制、并配合 spekit 规格工作流开发功能的团队或个人,在开始新功能开发前快速创建规范命名的功能分支。

限制

  • 仅负责分支创建,不创建规格目录或文件。
  • 依赖 Git 环境;非 Git 仓库中会跳过创建。
  • 需要存在相应的脚本文件(create-new-feature.sh 或 create-new-feature.ps1)。
  • 分支编号模式配置需位于指定路径。
  • 具体脚本行为细节、错误处理与平台兼容性暂未提供更多说明。