SuperAPI AI 工具集

speckit-git-feature

通用与其它

查看项目

更新于 10-16 03:43

技能介绍

用途:为给定 specification 创建并切换到新的 Git 功能分支。该命令只处理分支创建,规格目录和文件由核心 /speckit-specify 工作流创建。

主要能力:支持顺序编号或时间戳编号两种模式;可通过环境变量 GIT_BRANCH_NAME 覆盖分支名,此时脚本直接使用该值,忽略 --short-name、--number、--timestamp,若名称以数字前缀开头则从中提取 FEATURE_NUM,否则 FEATURE_NUM 为完整分支名。分支编号模式先查 .specify/extensions/git/git-config.yml 的 branch_numbering,再查 .specify/init-options.json(向后兼容),都没有则默认顺序编号。

使用方式:先确认 Git 可用,运行 git rev-parse --is-inside-work-tree 2>/dev/null。根据功能描述生成 2-4 词短名,尽量用动作-名词格式(如 add-user-auth、fix-payment-bug),保留 OAuth2、API、JWT 等技术术语。然后按平台执行脚本:Bash 为 .specify/extensions/git/scripts/bash/create-new-feature.sh --json --short-name "<short-name>" "<feature description>";时间戳模式加 --timestamp。PowerShell 为 .specify/extensions/git/scripts/powershell/create-new-feature.ps1 -Json -ShortName "<short-name>" "<feature description>";时间戳模式加 -Timestamp。注意不要传 --number,脚本会自动确定下一个编号;始终带上 JSON 标志;每个功能只运行一次该脚本。脚本 JSON 输出含 BRANCH_NAME 和 FEATURE_NUM,例如 003-user-auth 或 20260319-143022-user-auth。

限制:若未安装 Git 或当前目录不是 Git 仓库,则跳过分支创建并给出警告,脚本仍输出 BRANCH_NAME 与 FEATURE_NUM 供调用方引用。关于收费、平台支持等更多信息,资料暂未提供。