一个用于解析、验证和操作 Semantic Versioning 2.0.0 字符串的零依赖 Python 工具。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install semver-toolkit
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 semver-toolkit。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 SemVer Toolkit？
SemVer Toolkit 是一款强大的实用工具，旨在处理自动化环境中复杂的 Semantic Versioning (SemVer 2.0.0)。作为 Openclaw Skills 生态系统的一个特色部分，它为开发人员和 CI/CD 流水线提供了一种可靠的方法来管理软件版本控制，且无需外部依赖的开销。
通过严格遵守 SemVer 规范，此技能可确保版本控制逻辑（包括预发布优先级和构建元数据）在您的项目中得到一致应用。无论您是自动化发布流程还是验证用户输入，该工具包都能提供现代软件开发所需的精确度。
SemVer Toolkit 应用场景
- 在 CI/CD 流水线中针对主版本、次版本或补丁版本自动升级版本。
- 根据 SemVer 2.0.0 规范验证 git 标签或用户提供的版本字符串。
- 以编程方式比较版本号以确定升级路径或兼容性。
- 对大量的版本字符串列表进行排序，以便生成变更日志或更新清单。
SemVer Toolkit 工作原理
- 输入接收：该工具通过 CLI 接收一个或多个版本字符串，可选处理常见的 'v' 前缀。
- 组件解析：内部逻辑将字符串分解为其组成部分：主版本 (Major)、次版本 (Minor)、补丁版本 (Patch)、预发布 (Prerelease) 和构建元数据 (Build)。
- 逻辑执行：根据命令（bump、compare、sort），该工具应用 SemVer 特定的规则，例如识别出 1.0.0-alpha 小于 1.0.0。
- 结构化输出：结果将返回到控制台或作为 JSON 对象返回，以便与其他 Openclaw Skills 集成。
SemVer Toolkit 配置指南
由于此工具仅依赖于 Python 3 标准库，因此设置是瞬时完成的。请确保您的本地环境中拥有该脚本：
# Ensure you have Python 3 installed
python3 --version
# Make the script executable
chmod +x scripts/semver_toolkit.py
# Run a test validation
python3 scripts/semver_toolkit.py validate 1.0.0
SemVer Toolkit 数据架构与分类体系
该工具包将版本数据组织为五个主要段。使用 -f json 标志时，数据以结构化格式返回：
| Key | Description | Example |
|---|---|---|
major |
不兼容的变更增加 | 1 |
minor |
新功能增加 | 2 |
patch |
错误修复增加 | 3 |
prerelease |
预发布标识符 | beta.1 |
build |
构建元数据 | build.42 |
所有命令都支持 --format json 标志，以方便在更大的 Openclaw Skills 工作流中实现机器可读性。
SemVer Toolkit 高级特性
- 预发布标签：在升级过程中支持自定义预发布标签，如
rc、alpha或beta。 - 机器可读 JSON：每个命令都提供集成就绪的 JSON 输出模式。
- 反向排序：带有反转标志的高性能排序算法，用于降序排列发布版本。
- 零依赖架构：旨在 Alpine Linux 或受限 CI 运行器等极简环境中运行。
SKILL.md
加载中
Openclaw 相关技能
精选*
