← Back to list

release-standards
by AsiaOstrich
Universal, language-agnostic development standards for software projects. Includes coding standards, git workflows, testing guidelines, documentation structure, and AI collaboration rules.
⭐ 20🍴 3📅 Jan 23, 2026
SKILL.md
source: skills/claude-code/release-standards/SKILL.md source_version: 1.1.0 translation_version: 1.1.0 last_synced: 2026-01-02 status: current name: release-standards description: | 語意化版本控制和变更日誌格式化的软体發布标准。 使用时机:准备發布、更新版本号、撰写变更日誌。 关鍵字:version, release, changelog, semver, major, minor, patch, 版本, 發布, 变更日誌。
發布标准
语言: 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
版本递增規則
| 組成部分 | 何时递增 | 範例 |
|---|---|---|
| MAJOR | 重大变更 | 1.9.5 → 2.0.0 |
| MINOR | 新功能(向後相容) | 2.3.5 → 2.4.0 |
| PATCH | 错误修復(向後相容) | 3.1.2 → 3.1.3 |
预發布識别符
| 識别符 | 穩定性 | 目標受眾 |
|---|---|---|
alpha | 不穩定 | 內部团队 |
beta | 大致穩定 | 早期採用者 |
rc | 穩定 | Beta 测试者 |
CHANGELOG 分类
| 分类 | 用途 |
|---|---|
| Added | 新功能 |
| Changed | 現有功能的变更 |
| Deprecated | 即將移除的功能 |
| Removed | 已移除的功能 |
| Fixed | 错误修復 |
| Security | 安全性漏洞修復 |
详细指南
完整标准請參阅:
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
配置檢测
本技能支援项目特定配置。
檢测順序
- 检查
CONTRIBUTING.md中的「Disabled Skills」段落- 如果列出此技能,則該项目停用此技能
- 检查
CONTRIBUTING.md中的「Release Standards」段落 - 如果未找到,预设使用語意化版本控制和 Keep a Changelog 格式
首次设置
如果未找到配置且上下文不明确:
- 詢問使用者:「此项目尚未配置發布标准。您想使用語意化版本控制嗎?」
- 使用者选择後,建议在
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
相关标准
版本历史
| 版本 | 日期 | 变更内容 |
|---|---|---|
| 1.1.0 | 2026-01-02 | 新增:發布流程指南,包含完整發布流程 |
| 1.0.0 | 2025-12-24 | 新增:标准段落(目的、相关标准、版本历史、授权条款) |
授权条款
本技能依据 CC BY 4.0 授权發布。
Score
Total Score
75/100
Based on repository quality metrics
✓SKILL.md
SKILL.mdファイルが含まれている
+20
✓LICENSE
ライセンスが設定されている
+10
✓説明文
100文字以上の説明がある
+10
○人気
GitHub Stars 100以上
0/15
✓最近の活動
1ヶ月以内に更新
+10
○フォーク
10回以上フォークされている
0/5
✓Issue管理
オープンIssueが50未満
+5
✓言語
プログラミング言語が設定されている
+5
✓タグ
1つ以上のタグが設定されている
+5
Reviews
💬
Reviews coming soon


