SuperAPI AI 工具集

git-tag

编程与开发

查看项目

更新于 10-16 01:17

技能介绍

用途:在用户指定的 Git 仓库中,通过 cyeam CLI 创建指向当前 HEAD 的本地版本标签。适用于用户要求打 tag、大小版本升级,或显式调用 /git-tag、$git-tag 的场景;仅编辑技能说明或讨论版本规则时不执行打标签。

主要能力:默认 minor 升级(v1.2.3 → v1.3.0),支持 major(v1.2.3 → v2.0.0)和 --dry-run 预览。版本计算交给 CLI:以本地最大稳定版本 vMAJOR.MINOR.PATCH 为基准,忽略其他格式和预发布标签;没有匹配标签时从 v0.0.0 开始。

使用方式:/git-tag 或 $git-tag 默认执行 cyeam tag minor;/git-tag major 执行 cyeam tag major;/git-tag minor --dry-run 与 /git-tag major --dry-run 分别预览。只提供 --dry-run 时模式仍为 minor。未指定仓库时使用当前工作目录所属仓库。显式调用或明确要求打 tag 即视为授权创建本地标签,直接执行,无需再次确认或先预览。读取 CLI 结果后报告旧版本、新标签及目标提交;预览时说明尚未创建标签。默认 JSON 信封的 data 包含 previous、tag、commit、dry_run。

限制:CLI 要求工作区干净,包括暂存和未跟踪文件;失败时展示原因并停止,不自动提交、stash、删除文件或覆盖标签。需要提交时按用户意图使用 git-cmsg。此入口不接受 --force,不代表 git tag -f 或强制推送。默认只创建本地标签,仅在用户明确要求时拉取或推送,且推送使用本次成功创建的确切标签,不能推送所有标签或强制覆盖远端。CLI 未安装或不支持 tag 时,需安装或更新 cyeam,不要手算版本退回原生 git tag;若当前任务就是开发此 CLI,可从源码构建到临时目录并在目标仓库运行该二进制。