语义化版本控制实践指南：自动化版本管理与发布说明生成

semantic-versioning by aj-geddes/useful-ai-prompts

171 周安装量

141 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/aj-geddes/useful-ai-prompts --skill semantic-versioning

开发自动化代码规范

🇨🇳中文介绍

语义化版本控制

概述

建立语义化版本控制实践，以维护与发布重要性一致的版本号，实现自动化的版本管理和发布说明生成。

使用场景

包和库的发布
API 版本控制
版本号自动递增
发布说明生成
重大变更追踪
依赖管理
更新日志管理

快速开始

最小工作示例：

# package.json
{
  "name": "my-awesome-package",
  "version": "1.2.3",
  "description": "An awesome package",
  "main": "dist/index.js",
  "repository": { "type": "git", "url": "https://github.com/org/repo.git" },
  "scripts": { "release": "semantic-release" },
  "devDependencies":
    {
      "semantic-release": "^21.0.0",
      "@semantic-release/changelog": "^6.0.0",
      "@semantic-release/git": "^10.0.0",
      "@semantic-release/github": "^9.0.0",
      "conventional-changelog-cli": "^3.0.0",
    },
}

参考指南

references/ 目录下的详细实现：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

指南	内容
语义化版本控制配置	语义化版本控制配置
约定式提交格式	约定式提交格式
语义化发布配置	语义化发布配置
版本号递增脚本	版本号递增脚本
更新日志生成	更新日志生成

🇺🇸English

Semantic Versioning

Overview
When to Use
Quick Start
Reference Guides
Best Practices

Overview

Establish semantic versioning practices to maintain consistent version numbering aligned with release significance, enabling automated version management and release notes generation.

When to Use

Package and library releases
API versioning
Version bumping automation
Release note generation
Breaking change tracking
Dependency management
Changelog management

Quick Start

Minimal working example:

# package.json
{
  "name": "my-awesome-package",
  "version": "1.2.3",
  "description": "An awesome package",
  "main": "dist/index.js",
  "repository": { "type": "git", "url": "https://github.com/org/repo.git" },
  "scripts": { "release": "semantic-release" },
  "devDependencies":
    {
      "semantic-release": "^21.0.0",
      "@semantic-release/changelog": "^6.0.0",
      "@semantic-release/git": "^10.0.0",
      "@semantic-release/github": "^9.0.0",
      "conventional-changelog-cli": "^3.0.0",
    },
}

Reference Guides

Detailed implementations in the references/ directory:

Guide	Contents
Semantic Versioning Configuration	Semantic Versioning Configuration
Conventional Commits Format	Conventional Commits Format
Semantic Release Configuration	Semantic Release Configuration
Version Bumping Script	Version Bumping Script
Changelog Generation	Changelog Generation

Best Practices

✅ DO

Follow strict MAJOR.MINOR.PATCH format
Use conventional commits
Automate version bumping
Generate changelogs automatically
Tag releases in git
Document breaking changes
Use prerelease versions for testing

❌ DON'T

Manually bump versions inconsistently
Skip breaking change documentation
Use arbitrary version numbering
Mix features in patch releases

Weekly Installs

148

Repository

aj-geddes/usefu…-prompts

GitHub Stars

121

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode130

codex125

gemini-cli123

github-copilot108

claude-code108

cursor107