version-management
语义版本控制辅助工具和发布脚本。在管理版本、提升版本号、创建发布、生成变更日志时使用,或当用户提及版本控制、语义版本控制、发布管理、版本提升或semver时使用。
name: Version Management description: Semantic versioning helpers and release scripts. Use when managing versions, bumping version numbers, creating releases, generating changelogs, or when user mentions versioning, semantic versioning, release management, version bumps, or semver. allowed-tools: Read, Write, Edit, Bash
Version Management
This skill provides semantic versioning helpers, version bump scripts, changelog generation, and release management tools.
What This Skill Provides
1. Version Bump Scripts
bump-version.sh- Increment version (major/minor/patch)get-version.sh- Extract current version from project filesset-version.sh- Update version across all files
2. Changelog Generation
generate-changelog.sh- Create changelog from git commits- Conventional commit parsing
- Categorized changes (feat, fix, docs, etc.)
3. Release Scripts
create-release.sh- Tag and prepare releasevalidate-release.sh- Check release readiness- Git tag creation with annotations
4. Version File Templates
- package.json version field
- pyproject.toml version field
- Cargo.toml version field
- VERSION file template
Instructions
Bumping Version
When user wants to increment version:
- Detect current version from project files
- Parse semantic version (MAJOR.MINOR.PATCH)
- Increment appropriate component:
- major: Breaking changes (1.0.0 → 2.0.0)
- minor: New features (1.0.0 → 1.1.0)
- patch: Bug fixes (1.0.0 → 1.0.1)
- Update all version files
Execute:
!{bash plugins/01-core/skills/version-management/scripts/bump-version.sh major} !{bash plugins/01-core/skills/version-management/scripts/bump-version.sh minor} !{bash plugins/01-core/skills/version-management/scripts/bump-version.sh patch}
Generating Changelog
When user wants changelog:
- Get commits since last tag
- Parse conventional commit messages
- Categorize by type (feat, fix, docs, etc.)
- Format as markdown with links
Execute:
!{bash plugins/01-core/skills/version-management/scripts/generate-changelog.sh}
Creating Release
When user wants to create release:
- Validate no uncommitted changes
- Bump version
- Update changelog
- Create git commit
- Create git tag
- Display next steps (push, publish)
Semantic Versioning Rules
MAJOR (X.0.0):
- Breaking changes
- Incompatible API changes
- Major refactoring
MINOR (x.Y.0):
- New features
- Backward-compatible additions
- Deprecations
PATCH (x.y.Z):
- Bug fixes
- Performance improvements
- Documentation updates
Success Criteria
- ✅ Version follows semver format
- ✅ All version files updated consistently
- ✅ Changelog generated from commits
- ✅ Git tag created with version
- ✅ Release is reproducible
Plugin: 01-core Skill Type: Helper + Generator Auto-invocation: Yes (via description matching)