changelog-generator
24
总安装量
6
周安装量
#15251
全站排名
安装命令
npx skills add https://github.com/eyadsibai/ltk --skill changelog-generator
Agent 安装分布
gemini-cli
5
antigravity
5
claude-code
5
cursor
4
qwen-code
4
windsurf
4
Skill 文档
Changelog Generator
Transform technical git commits into polished, user-friendly changelogs.
When to Use
- Preparing release notes for a new version
- Creating weekly or monthly product update summaries
- Documenting changes for customers
- Writing changelog entries for app store submissions
- Generating update notifications
- Maintaining a public changelog/product updates page
Process
1. Scan Git History
Analyze commits from a specific time period or between versions:
# Since last tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline
# Between dates
git log --since="2024-01-01" --until="2024-01-31" --oneline
# Between versions
git log v1.0.0..v2.0.0 --oneline
2. Categorize Changes
Group commits into logical categories:
| Category | Emoji | Includes |
|---|---|---|
| New Features | ⨠| New functionality, capabilities |
| Improvements | ð§ | Enhancements, optimizations |
| Bug Fixes | ð | Resolved issues, corrections |
| Breaking Changes | â ï¸ | API changes, migrations needed |
| Security | ð | Security patches, vulnerability fixes |
| Documentation | ð | Docs updates (usually excluded) |
| Internal | ð¨ | Refactoring, tests (usually excluded) |
3. Translate Technical â User-Friendly
Bad (developer-speak):
fix: resolve null pointer in UserService#getById
refactor: extract common logic to BaseRepository
Good (user-friendly):
- Fixed an issue where user profiles wouldn't load
- Improved application performance and reliability
4. Format Output
# Updates - Week of March 10, 2024
## ⨠New Features
- **Team Workspaces**: Create separate workspaces for different
projects. Invite team members and keep everything organized.
## ð§ Improvements
- **Faster Sync**: Files now sync 2x faster across devices
- **Better Search**: Search now includes file contents, not just titles
## ð Fixes
- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
Filter Rules
Include:
- Features (feat:, feature:)
- Fixes (fix:, bugfix:)
- Performance (perf:)
- Security (security:)
Exclude:
- Refactoring (refactor:)
- Tests (test:)
- CI/CD (ci:, build:)
- Chores (chore:)
- WIP commits
Usage Examples
Create a changelog from commits since last release
Generate changelog for all commits from the past week
Create release notes for version 2.5.0 based on commits since v2.4.0
Tips
- Run from your git repository root
- Specify date ranges for focused changelogs
- Review and adjust before publishing
- Keep customer perspective – “what does this mean for them?”
- Save output directly to CHANGELOG.md