Claude Code skill: Automatically generate structured changelogs from git tags to HEAD with semantic version recommendations.
This project was primarily generated by Claude Code, with minor adjustments by the author.
- Automatic Version Detection: Retrieve the latest semantic version from git tags
- Intelligent Classification: Automatically categorize changes by type (FEAT, FIX, BREAKING, etc.)
- Semantic Version Calculation: Compute MAJOR, MINOR, PATCH upgrades based on changes
- Bilingual Output: Generated changelogs include English descriptions with Chinese translations
- Structured Format: Output clean Markdown-formatted changelogs
Add this skill to your Claude Code skills directory:
# Clone to Claude Code skills directory
git clone https://github.com/pardnchiu/skill-version-generate ~/.claude/skills/version-generateInvoke this skill with Claude Code in your project directory:
/version-generate
The skill automatically executes the following workflow:
- Version Detection: Retrieve the latest semantic version tag (e.g.,
v1.2.3) - Change Collection: Analyze all git diffs from tag to HEAD
- Classification Calculation: Determine version bump based on change types
- Generate Output: Create
vA.B.C.mdchangelog file
| Change Type | Version Impact |
|---|---|
BREAKING |
MAJOR (+1.0.0) |
FEAT |
MINOR (+0.1.0) |
FIX, UPDATE, SECURITY, REFACTOR, PERF |
PATCH (+0.0.1) |
STYLE, DOC, TEST, CHORE |
No bump |
Generated file format like v1.3.0.md:
> v1.2.3 -> v1.3.0
## Summary
Add task scheduling feature and fix memory leak issue.
## Changes
### FEAT
- Add task scheduler with cron expression support
### FIX
- Fix memory leak in worker pool cleanup| Tag | Scope | Example |
|---|---|---|
FEAT |
New feature | New function, endpoint, component |
FIX |
Bug fix | Error handling, logic fix |
UPDATE |
Modify existing behavior | Parameter change, algorithm adjustment |
ADD |
Add files/resources | Config files, assets, dependencies |
REMOVE |
Delete | Deprecated code, unused files |
REFACTOR |
Code restructure | Extract function, rename |
PERF |
Performance improvement | Caching, algorithm optimization |
STYLE |
Formatting | Whitespace, linting |
DOC |
Documentation | Comments, README |
TEST |
Tests | New tests, test fixes |
CHORE |
Maintenance | CI/CD, tooling |
SECURITY |
Security patch | Vulnerability fix |
BREAKING |
Breaking change | API signature change |
This project is licensed under the MIT LICENSE.