Changelog Generator

Changelog Generator Skill

Overview

Автоматическая генерация CHANGELOG из git коммитов. Семантическое версионирование, группировка по типам.

When to Use

• Релиз новой версии
• Подготовка release notes
• Документирование изменений
• CI/CD pipeline для changelog

Changelog Format

Keep a Changelog Standard

# Changelog

All notable changes to this project will be documented in this file.

## [Unreleased]

## [1.2.0] - 2024-01-15

### Added
- New user authentication system
- Dark mode support

### Changed
- Improved performance of search

### Deprecated
- Old API endpoints (will remove in 2.0)

### Removed
- Legacy database driver

### Fixed
- Memory leak in image processing
- Login redirect bug

### Security
- Updated dependencies with CVE fixes

Semantic Versioning

MAJOR.MINOR.PATCH

MAJOR - Breaking changes (feat!:, BREAKING CHANGE)
MINOR - New features (feat:)
PATCH - Bug fixes (fix:)

Commit Types → Changelog Sections

Generation Algorithm

Готового скрипта навык НЕ содержит — в папке changelog-generator/ только этот SKILL.md. Код ниже — исходник, который надо сохранить в СВОЁМ репозитории (обычно scripts/changelog.py) и добавить к нему разбор аргументов --version / --since / --dry-run. Все команды в разделах «CLI Usage» и «Integration with CI/CD» подразумевают уже сохранённый файл, а не поставку навыка.

import subprocess
import re
from datetime import datetime

def get_commits_since_tag(tag: str = None) -> list:
    """Get commits since last tag"""
    if tag:
        cmd = f"git log {tag}..HEAD --pretty=format:'%H|%s|%b' --no-merges"
    else:
        cmd = "git log --pretty=format:'%H|%s|%b' --no-merges"

    result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
    commits = []

    for line in result.stdout.strip().split('\n'):
        if '|' in line:
            parts = line.split('|', 2)
            commits.append({
                'hash': parts[0][:7],
                'subject': parts[1],
                'body': parts[2] if len(parts) > 2 else ''
            })
    return commits

def parse_conventional_commit(subject: str) -> dict:
    """Parse conventional commit format"""
    pattern = r'^(\w+)(\([\w-]+\))?(!)?:\s*(.+)$'
    match = re.match(pattern, subject)

    if match:
        return {
            'type': match.group(1),
            'scope': match.group(2)[1:-1] if match.group(2) else None,
            'breaking': bool(match.group(3)),
            'description': match.group(4)
        }
    return {'type': 'other', 'description': subject}

def categorize_commits(commits: list) -> dict:
    """Group commits by type"""
    categories = {
        'breaking': [],
        'added': [],
        'changed': [],
        'deprecated': [],
        'removed': [],
        'fixed': [],
        'security': []
    }

    type_mapping = {
        'feat': 'added',
        'fix': 'fixed',
        'perf': 'changed',
        'refactor': 'changed',
        'security': 'security',
        'deprecate': 'deprecated',
        'remove': 'removed'
    }

    for commit in commits:
        parsed = parse_conventional_commit(commit['subject'])

        # Check for breaking changes
        if parsed.get('breaking') or 'BREAKING CHANGE' in commit.get('body', ''):
            categories['breaking'].append(commit)
            continue

        category = type_mapping.get(parsed['type'])
        if category:
            categories[category].append(commit)

    return categories

def generate_changelog(version: str, categories: dict) -> str:
    """Generate changelog markdown"""
    date = datetime.now().strftime('%Y-%m-%d')
    lines = [f"## [{version}] - {date}\n"]

    section_names = {
        'breaking': '### ⚠️ Breaking Changes',
        'added': '### Added',
        'changed': '### Changed',
        'deprecated': '### Deprecated',
        'removed': '### Removed',
        'fixed': '### Fixed',
        'security': '### Security'
    }

    for key, title in section_names.items():
        if categories.get(key):
            lines.append(f"\n{title}\n")
            for commit in categories[key]:
                parsed = parse_conventional_commit(commit['subject'])
                scope = f"**{parsed['scope']}**: " if parsed.get('scope') else ""
                lines.append(f"- {scope}{parsed['description']}")

    return '\n'.join(lines)

CLI Usage

# Generate changelog for next version
python changelog.py --version 1.2.0

# Generate since specific tag
python changelog.py --since v1.1.0 --version 1.2.0

# Output to file
python changelog.py --version 1.2.0 >> CHANGELOG.md

# Preview only
python changelog.py --version 1.2.0 --dry-run

Git Commands

# Get last tag
git describe --tags --abbrev=0

# Commits since last tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline

# All tags sorted by date
git tag --sort=-creatordate

# Create new tag
git tag -a v1.2.0 -m "Release 1.2.0"
git push origin v1.2.0

Integration with CI/CD

GitHub Actions

name: Generate Changelog

on:
  push:
    tags:
      - 'v*'

jobs:
  changelog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Generate Changelog
        id: changelog
        run: |
          VERSION=${GITHUB_REF#refs/tags/v}
          python scripts/changelog.py --version $VERSION > release_notes.md

      - name: Create Release
        uses: softprops/action-gh-release@v1
        with:
          body_path: release_notes.md

Best Practices

1. Conventional Commits - используй стандартный формат
2. Scope - указывай область изменения: feat(auth):
3. Breaking Changes - всегда помечай ! или BREAKING CHANGE
4. Атомарные коммиты - один коммит = одно изменение
5. User-facing - пиши для пользователей, не для разработчиков

Example Output

## [2.1.0] - 2024-01-15

### ⚠️ Breaking Changes
- **api**: Changed response format for /users endpoint

### Added
- **auth**: OAuth2 login with Google and GitHub
- **ui**: Dark mode toggle in settings
- **search**: Full-text search across all documents

### Changed
- **performance**: Reduced API response time by 40%
- **database**: Migrated to connection pooling

### Fixed
- **auth**: Fixed session expiration handling
- **ui**: Corrected button alignment on mobile
- **api**: Resolved null pointer in user endpoint

### Security
- Updated axios to fix CVE-2024-xxxx

Tips

1. Squash before merge - чистая история = чистый changelog
2. PR title = commit message - при squash merge
3. Автоматизируй - добавь в CI/CD
4. Версионируй правильно - breaking = major, feat = minor, fix = patch