安装命令
npx skills add https://github.com/alienfast/claude --skill 'Semantic Version Advisor'🇨🇳中文介绍
语义化版本顾问
此技能帮助分类版本变更、确定适当的版本升级并验证语义化版本决策。
快速参考
版本格式 : MAJOR.MINOR.PATCH
- MAJOR : 破坏性变更，不兼容的 API 更改
- MINOR : 新功能，向后兼容的添加
- PATCH : 错误修复，向后兼容的修复
核心工作流
工作流 1：分类版本变更
输入 : 旧版本和新版本 输出 : 分类（MAJOR/MINOR/PATCH）及解释
决策树
┌─────────────────────────────────┐
│ 比较版本 X.Y.Z │
└────────────┬────────────────────┘
│
v
┌────────────────┐
│ X 改变了吗？ │─ 是 ──> MAJOR（破坏性变更）
└────┬───────────┘
│ 否
v
┌────────────────┐
│ Y 改变了吗？ │─ 是 ──> MINOR（新功能）
└────┬───────────┘
│ 否
v
┌────────────────┐
│ Z 改变了吗？ │─ 是 ──> PATCH（错误修复）
└────┬───────────┘
│ 否
v
版本相同
分类步骤
- 解析版本 : 从两个版本中提取
MAJOR.MINOR.PATCH - 去除符号 : 移除
^、~、>=等前缀（如果存在） - 比较 MAJOR : 如果不同 → MAJOR 变更
- 比较 MINOR : 如果不同 → MINOR 变更
- 比较 PATCH : 如果不同 → PATCH 变更
- 验证 : 确认分类与变更类型匹配
示例
^4.0.0 → ^5.0.0 = MAJOR (4 → 5, 破坏性变更)
^13.1.5 → ^13.2.0 = MINOR (1 → 2, 新功能)
^7.1.5 → ^7.1.6 = PATCH (5 → 6, 错误修复)
9.35.0 → 9.36.0 = MINOR (35 → 36, 新功能)
1.0.0 → 1.0.1 = PATCH (0 → 1, 错误修复)
工作流 2：确定版本升级
输入 : 发布中包含的变更列表 输出 : 推荐的版本升级（MAJOR/MINOR/PATCH）
变更分类
需要 MAJOR 升级，如果存在以下任意情况 :
- 破坏性 API 变更（移除方法、更改签名）
- 不兼容的行为变更
- 移除公共 API 或接口
- 更改默认行为导致现有代码失效
- 重命名公共模块或包
- 放弃对语言/运行时版本的支持
需要 MINOR 升级，如果存在以下任意情况 :
- 添加新功能或能力
- 添加新 API 或方法
- 添加新的可选参数
- 弃用 API（但仍可运行）
- 性能改进（非破坏性）
- 添加新依赖
PATCH 升级，如果满足以下所有条件 :
- 仅包含错误修复
- 文档更新
- 内部重构（无 API 变更）
- 安全补丁（向后兼容）
- 测试改进
- 构建流程变更
决策流程
从 PATCH 开始（默认）
↓
对于每个变更：
- 是破坏性变更吗？ → 升级到 MAJOR，停止
- 是新功能吗？ → 升级到 MINOR，继续
- 是错误修复吗？ → 保持当前级别，继续
↓
返回遇到的最高级别
示例分析
变更列表 :
- 修复了
getData()中的空指针异常 - 添加了新的
fetchAsync()方法 - 更新了文档
分析 :
- 空指针修复 → PATCH 候选
- 新方法 → MINOR 升级（覆盖 PATCH）
- 文档 → 无影响
结果 : MINOR 升级（添加了新功能）
工作流 3：验证版本提案
输入 : 当前版本、提议版本、变更列表 输出 : 验证结果（有效/无效）及原因
验证规则
- 版本必须递增 : 新版本 > 当前版本
- 仅一个部分递增 : 递增 MAJOR 或 MINOR 或 PATCH
- 重置较低部分 : 递增时，将较低部分重置为 0
- MAJOR 升级:
1.5.3 → 2.0.0✅（MINOR 和 PATCH 重置） - MINOR 升级:
1.5.3 → 1.6.0✅（PATCH 重置） - PATCH 升级:
1.5.3 → 1.5.4✅（无需重置）
- MAJOR 升级:
- 匹配变更严重性 : 版本升级需匹配最严重的变更
- 破坏性变更 → 需要 MAJOR
- 新功能 → 至少需要 MINOR
- 仅错误修复 → PATCH 合适
验证示例
有效 :
1.2.3 → 2.0.0包含破坏性变更 ✅1.2.3 → 1.3.0包含新功能 ✅1.2.3 → 1.2.4包含错误修复 ✅
无效 :
1.2.3 → 1.4.0（跳过 MINOR 版本） ❌1.2.3 → 2.1.0（MINOR 未重置为 0） ❌1.2.3 → 1.2.3（无变更） ❌1.2.3 → 1.3.0包含破坏性变更（版本过低） ❌1.2.3 → 2.0.0仅包含错误修复（版本过高） ❌
常见陷阱
❌ 错误分类范围符号
错误 : ^7.1.5 → ^7.1.6 = "Major"，因为存在脱字符 正确 : ^7.1.5 → ^7.1.6 = PATCH（忽略 ^，比较数字）
❌ 假设包的重要性
错误 : 核心包变更 → 必须是 MAJOR 正确 : 根据版本号分类，而非包的重要性
❌ 忽略重置规则
错误 : 1.5.3 → 2.1.0 作为 MAJOR 升级 正确 : 1.5.3 → 2.0.0 作为 MAJOR 升级（重置 MINOR 和 PATCH）
❌ 安全假设
错误 : 安全修复 → 必须是 PATCH 正确 : 安全修复可以是任何级别（破坏性修复 = MAJOR）
预发布版本
格式
1.0.0-alpha.1- Alpha 预发布1.0.0-beta.2- Beta 预发布1.0.0-rc.1- 发布候选
优先级
1.0.0-alpha.1
< 1.0.0-alpha.beta
< 1.0.0-beta
< 1.0.0-beta.2
< 1.0.0-rc.1
< 1.0.0
预发布分类
1.0.0 → 1.0.0-alpha.1= 预发布（无语义化版本升级）1.0.0-beta.1 → 1.0.0= 正式发布（无语义化版本变更）1.0.0-rc.1 → 1.1.0= 从 RC 到 MINOR 发布
按类型划分的研究深度
MAJOR 版本变更
所需研究 :
- 完整更新日志审查
- 破坏性变更分析
- 迁移指南审查
- API 兼容性检查
- 测试覆盖率验证
时间投入 : 高（30-60 分钟）
MINOR 版本变更
所需研究 :
- 功能概述
- 弃用 API 检查
- 新依赖审查
- 高级兼容性检查
时间投入 : 中等（10-20 分钟）
PATCH 版本变更
所需研究 :
- 仅检查安全公告
- 跳过详细更新日志审查
时间投入 : 低（2-5 分钟）
与其他工具的集成
NPM/pnpm 命令
# 查看过时包及其版本信息
npm outdated
# 机器可读的升级信息
npx ncu --jsonUpgraded
# pnpm 版本检查
pnpm outdated
Semver 实用命令
# 分类版本差异
semver diff 1.2.3 1.3.0 # 输出: "minor"
# 比较版本
semver gt 1.3.0 1.2.3 # 输出: true
# 检查范围满足情况
semver satisfies 1.2.4 "^1.2.3" # 输出: true
建议模板
模板：版本升级建议
**推荐版本升级**: [MAJOR/MINOR/PATCH]
**当前版本**: X.Y.Z
**提议版本**: A.B.C
**变更摘要**:
- [破坏性/功能/修复]: 描述
**原因**:
[根据变更类型解释此分类的原因]
**迁移说明**（如果是 MAJOR）:
[消费者所需的步骤]
模板：依赖更新分类
**包**: package-name
**版本变更**: X.Y.Z → A.B.C
**分类**: [MAJOR/MINOR/PATCH]
**影响评估**:
- 破坏性变更: [是/否]
- 新功能: [是/否]
- 安全修复: [是/否]
**推荐操作**: [立即更新/先测试/仔细审查]
快速分类图表
| 旧版本 | 新版本 | 变更类型 | 分类 |
|---|---|---|---|
| 1.2.3 | 2.0.0 | X 改变 | MAJOR |
| 1.2.3 | 1.3.0 | Y 改变 | MINOR |
| 1.2.3 | 1.2.4 | Z 改变 | PATCH |
| ^4.0.0 | ^5.0.0 | X 改变 | MAJOR |
| ~1.2.3 | ~1.3.0 | Y 改变 | MINOR |
| 9.35.0 | 9.36.0 | Y 改变 | MINOR |
| 0.2.3 | 0.3.0 | Y 改变 | MINOR (0.x) |
资源
完整规范
有关完整的语义化版本规则和标准，请参阅：~/.claude/standards/semver.md
每周安装数
0
仓库
首次出现
1970年1月1日
安全审计
🇺🇸English
Semantic Version Advisor
This skill helps classify version changes, determine appropriate version bumps, and validate semantic versioning decisions.
Quick Reference
Version Format : MAJOR.MINOR.PATCH
- MAJOR : Breaking changes, incompatible API changes
- MINOR : New features, backward-compatible additions
- PATCH : Bug fixes, backward-compatible fixes
Core Workflows
Workflow 1: Classify Version Change
Input : Old version and new version Output : Classification (MAJOR/MINOR/PATCH) with explanation
Decision Tree
┌─────────────────────────────────┐
│ Compare versions X.Y.Z │
└────────────┬────────────────────┘
│
v
┌────────────────┐
│ X changed? │─ YES ──> MAJOR (breaking changes)
└────┬───────────┘
│ NO
v
┌────────────────┐
│ Y changed? │─ YES ──> MINOR (new features)
└────┬───────────┘
│ NO
v
┌────────────────┐
│ Z changed? │─ YES ──> PATCH (bug fixes)
└────┬───────────┘
│ NO
v
Same version
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
