release-standards

發布標準

語言: English | 繁體中文

版本: 1.1.0 最後更新: 2026-01-02 適用範圍: Claude Code Skills

目的

本技能提供語意化版本控制和變更日誌格式化標準。

快速參考

語意化版本格式

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

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

版本遞增規則

預發布識別符

CHANGELOG 分類

詳細指南

完整標準請參閱：

• 語意化版本控制指南
• 變更日誌格式
• 發布流程指南 - 本專案完整發布流程

CHANGELOG 條目格式

## [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 前綴標記重大變更：

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

Git 標籤

# 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

版本排序

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

配置檢測

本技能支援專案特定配置。

檢測順序

1. 檢查 CONTRIBUTING.md 中的「Disabled Skills」段落
   • 如果列出此技能，則該專案停用此技能
2. 檢查 CONTRIBUTING.md 中的「Release Standards」段落
3. 如果未找到，預設使用語意化版本控制和 Keep a Changelog 格式

首次設定

如果未找到配置且上下文不明確：

1. 詢問使用者：「此專案尚未配置發布標準。您想使用語意化版本控制嗎？」
2. 使用者選擇後，建議在 CONTRIBUTING.md 中記錄：

## Release Standards

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

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

配置範例

在專案的 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

相關標準

• 版本控制
• 變更日誌標準
• Git 工作流程

版本歷史

授權條款

本技能依據 CC BY 4.0 授權發布。

來源: universal-dev-standards