语义化版本验证器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install semantic-version-validator
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 semantic-version-validator。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

语义化版本验证器可帮助开发者检查版本是否遵循文档规定的 SemVer 2.0.0 结构，并判断变更需要 MAJOR、MINOR 还是 PATCH 升级。它涵盖核心版本号、可选的预发布和构建元数据、预发布标识符，以及关于 0.y.z 和 1.0.0 的特殊要求。
作为 Openclaw Skills 中用于准备发布的技能之一，它为变更日志审查和预发布工作流提供专门的版本检查。使用它可以让版本决策更加一致：不兼容的 API 变更建议升级 MAJOR，向后兼容的功能建议升级 MINOR，错误修复建议升级 PATCH。

应用场景

在准备发布前检查拟定的版本字符串。
对不兼容的 API 变更选择 MAJOR 升级，对向后兼容的功能选择 MINOR 升级，或对错误修复选择 PATCH 升级。
准备预览版本时添加预发布标签，例如
alpha.1
。
对变更日志条目进行分类时检查版本号。
项目仍处于 0.y.z 范围时，遵循文档规定的初始开发指导。

工作原理

提供要检查的版本字符串；如果需要升级建议，还要描述变更类型。
此技能会根据文档规定的 MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD] 结构及其数字组成部分的限制检查版本。
如果存在预发布标识符，它会检查其中的标识符是否仅使用 ASCII 字母、数字或连字符，并以句点分隔。
比较预发布版本时，它会应用文档规定的规则：数字标识符低于字母标识符排序，且数字标识符按数值比较。
它会建议相应的升级类型：不兼容的 API 变更升级 MAJOR，向后兼容的功能升级 MINOR，错误修复升级 PATCH，预览版本则添加预发布标识符。

配置指南

SKILL.md 未指定软件包安装、CLI 命令、配置文件或外部依赖。请通过能够使用该技能的 AI 编码代理调用此技能，并提供要审查的版本字符串和相关变更类型。
示例请求：
验证版本 1.2.3，并针对向后兼容的功能推荐升级类型。

数据架构

此技能记录了评估输入的规则；它没有定义持久化存储、生成的文件或正式的机器可读响应架构。
信息 文档规定的结构或指导
版本字符串 MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
核心组成部分 MAJOR、MINOR 和 PATCH 均为非负数，文档规定每个数的范围为 0 到 99999999。
预发布 可选的、以句点分隔的标识符；允许使用 ASCII 字母、数字和连字符。示例包括 alpha.1、beta.2 和 rc.1。
构建元数据 + 后可选的、以句点分隔的标识符。
变更分类 不兼容的 API 变更 → MAJOR；向后兼容的功能 → MINOR；错误修复 → PATCH；预览版本 → 添加预发布标识符。
版本背景 0.y.z 表示初始开发；1.0.0 定义公共 API。
文档规定的递增规则指出，当某个版本组成部分增加时，应根据情况将更低位的 MAJOR、MINOR 或 PATCH 组成部分重置为零。

高级特性

支持版本字符串中的预发布和构建元数据部分。
提供预发布标识符字符和排序方面的指导，包括对数字标识符进行数值比较。
考虑初始开发版本（ 0.y.z ）以及
这一公共 API 里程碑。
将变更分类直接关联到发布升级建议，适用于变更日志和预发布检查。
提供的技能中未指定钩子、自动文件编辑、多代理功能或命令行界面。

name: semantic-version-validator description: "Validate semantic versioning (SemVer) strings and recommend the correct version bump (MAJOR/MINOR/PATCH) based on change type.适用于版本校驗、changelog 分級與發布前檢查。"

Semantic Version Validator

驗證版本字串是否符合 SemVer 2.0.0，並根據變更類型推薦正確的版本 bump。

規則

1. 格式驗證 MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

MAJOR：0-99999999 的數字，不可為負
MINOR：0-99999999 的數字，不可為負
PATCH：0-99999999 的數字，不可為負
PRERELEASE：可選，由 . 分隔的識別字串（例如 alpha.1、beta.2、rc.1）
BUILD：可選，由 . 分隔的識別字串 2. Bump 規則 變更類型 Bump 範例
破壞性 API 變更 MAJOR 1.0.0 → 2.0.0
新功能（向後相容） MINOR 1.0.0 → 1.1.0
Bug 修復 PATCH 1.0.0 → 1.0.1
預覽版本 附加 prerelease 1.0.0 → 1.0.1-alpha.1 3. 預覽版本規則

預覽版本識別字必須只包含 ASCII 字母數字和連字號 [0-9A-Za-z-]。 預覽版本比較：數字識別字 < 字母識別字，數字識別字之間做數值比較。

4. 約束 0.y.z 表示初始開發階段，任何版本都可能變更 1.0.0 定義公開 API 版本號遞增時，MAJOR/MINOR/PATCH 各自歸零
   AgentScope 模型比较
   QwenPaw 升级助手