name: release-standards
scope: universal
description: |
Semantic versioning and changelog formatting for software releases.
Use when: preparing releases, updating version numbers, writing changelogs.
Keywords: version, release, changelog, semver, major, minor, patch, 版本, 發布, 變更日誌.

Release Standards

Language: English | 繁體中文

Version: 1.1.1
Last Updated: 2026-01-30
Applicability: Claude Code Skills

Core Standard: This skill implements Versioning. For comprehensive methodology documentation, refer to the core standard.

Purpose

This skill provides semantic versioning and changelog formatting standards.

Quick Reference

Semantic Versioning Format

MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

Examples:
2.3.1
1.0.0-alpha.1
3.2.0-beta.2+20250112

Version Incrementing Rules

Pre-release Identifiers

CHANGELOG Categories

Detailed Guidelines

For complete standards, see:
- Semantic Versioning Guide
- Changelog Format
- Release Workflow Guide - Complete release process for this project

AI-Optimized Format (Token-Efficient)

For AI assistants, use the YAML format file for reduced token usage:
- Changelog: ai/standards/changelog.ai.yaml

CHANGELOG Entry Format

## [VERSION] - YYYY-MM-DD

### Added
- Add user dashboard with customizable widgets (#123)

### Changed
- **BREAKING**: Change API response format from XML to JSON

### Fixed
- Fix memory leak when processing large files (#456)

### Security
- Fix SQL injection vulnerability (CVE-2025-12345)

Breaking Changes

Mark breaking changes with BREAKING prefix:

### Changed
- **BREAKING**: Remove deprecated `getUserById()`, use `getUser()` instead

Git Tagging

# Create annotated tag (recommended)
git tag -a v1.2.0 -m "Release version 1.2.0"

# Push tag to remote
git push origin v1.2.0

Version Ordering

1.0.0-alpha.1 < 1.0.0-alpha.2 < 1.0.0-beta.1 < 1.0.0-rc.1 < 1.0.0

Configuration Detection

This skill supports project-specific configuration.

Detection Order

1. Check CONTRIBUTING.md for "Disabled Skills" section
2. If this skill is listed, it is disabled for this project
3. Check CONTRIBUTING.md for "Release Standards" section
4. If not found, default to Semantic Versioning and Keep a Changelog format

First-Time Setup

If no configuration found and context is unclear:

1. Ask the user: "This project hasn't configured release standards. Would you like to use Semantic Versioning?"
2. After user selection, suggest documenting in CONTRIBUTING.md:

## Release Standards

### Versioning
This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).

### Changelog
This project follows **Keep a Changelog** format.

Configuration Example

In project's CONTRIBUTING.md:

## Release Standards

### Versioning
This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).

### Changelog
This project follows **Keep a Changelog** format.

### Release Process
1. Update version in package.json
2. Update CHANGELOG.md
3. Create git tag with `v` prefix (e.g., v1.2.0)
4. Push tag to trigger release workflow

Related Standards

• Versioning - Core semantic versioning standard
• Changelog Standards - Keep a Changelog format
• Git Workflow - Git tagging and release branches

Version History

License

This skill is released under CC BY 4.0.

Source: universal-dev-standards