SuperAPI AI 工具集

speckit-git-validate

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能用于校验当前 Git 分支是否遵循预期的功能分支命名规范,并验证 specs/ 目录下是否存在对应的规格目录。它来自 opsmill/infrahub 的 speckit 工作流,属于自动化校验类技能。

主要能力:先检测 Git 是否可用(git rev-parse --is-inside-work-tree 2>/dev/null);不可用时输出警告并跳过校验:[specify] Warning: Git repository not detected; skipped branch validation。随后获取当前分支名(git rev-parse --abbrev-ref HEAD),并判断其是否匹配两种命名模式之一:顺序编号 ^[0-9]{3,}- (如 001-feature-name、042-fix-bug、1000-big-feature);时间戳 ^[0-9]{8}-[0-9]{6}- (如 20260319-143022-feature-name)。

执行结果:若在功能分支上,输出 ✓ On feature branch: <branch-name>,并按前缀查找 specs/<prefix>-*:顺序分支用数字部分匹配,时间戳分支用 YYYYMMDD-HHMMSS 部分匹配。找到时输出 ✓ Spec directory found: <path>,缺失时输出 ⚠ No spec directory found for prefix <prefix>。若不在功能分支上,输出 ✗ Not on a feature branch. Current branch: <branch-name>,并提示命名示例 001-feature-name 或 20260319-143022-feature-name。

优雅降级:当 Git 未安装或当前目录不是 Git 仓库时,改用 SPECIFY_FEATURE 环境变量作为回退;若已设置,则按命名模式校验该值;未设置则输出警告并跳过校验。

适用场景与限制:适合在 speckit 规范驱动开发流程中自动检查分支命名与规格目录一致性。其判定依赖上述正则与 specs/ 目录结构;关于安装方式、运行入口、收费模式与平台支持等细节,资料暂未提供。