| name | changelog-generator |
| description | "Генерация раздела CHANGELOG (Keep a Changelog) из git-истории по Conventional Commits. Скрипт changelog_gen.py читает git log в диапазоне tag..HEAD, парсит commit-сообщения, маппит типы (feat→Added, fix→Fixed, perf/refactor→Changed, breaking→отдельная секция) и рендерит Markdown с датами и ссылками на коммиты. Режимы: --top (Unreleased), --from-tag, включая скрытые типы (docs/ci/chore) через флаг. Триггеры: 'changelog', 'сгенерай чанжлог', 'обнови changelog', 'release notes', 'история изменений', 'keep a changelog', 'generate changelog', 'сборка changelog'.", |
Changelog Generator
Генерация раздела CHANGELOG из git-истории: анализ commit-логов, группировка
по Keep a Changelog секциям, готовый Markdown в stdout или файл.
Загружай этот скилл когда нужно сгенерировать/обновить changelog из истории
коммитов для релиза или представительской проверки. Скилл читает git log,
классифицирует изменения по типам и выдаёт готовый Markdown.
🎯 When to use
Use this skill when:
- Нужно сгенерировать
CHANGELOG.md перед релизом (секции Added/Fixed/Changed)
- Нужен «что нового» для PR или release notes
- Просят «созерай чанлог», «обнови changelog», «история изменений»
- Нужно быстро посмотреть, какие фичи/фиксы попали в диапазон тегов
Do NOT use when:
- Лог коммитов нужен «как есть» (без группировки) — это обычный git log
- Нужна переносим MVP-типов вручную — скрипт уже делает маппинг
- Репозиторий не использует Conventional Commits — маппинг будет пустым
📦 Files
SKILL.md — этот файлscripts/changelog_gen.py — основной скрипт (Python 3 stdlib only)
🔧 Usage
python3 skills/changelog-generator/scripts/changelog_gen.py --repo <path> --top
python3 skills/changelog-generator/scripts/changelog_gen.py \
--repo <path> --from-tag v1.0.0 --version 1.1.0
python3 changelog_gen.py --repo <path> --top --all
python3 changelog_gen.py --repo <path> --top --out CHANGELOG.md
🔄 Маппинг типов
| Conventional Commits | Секция | Замечание |
|---|
feat: ... | Added | Новая функциональность |
fix: ... | Fixed | Багификсы |
perf: / refactor: | Changed | Изменения поведения |
revert: | Reverts | Откаты |
breaking (! или BREAKING CHANGE:) | Breaking | Выносится в свою секцию |
| docs/style/test/build/ci/chore | скрыты | Видны только с --all |
✅ Definition of Done
- Скрипт отработал без ошибок: stdout или файл с секциями Added/Fixed/Changed.
- Breaking-коммиты вынесены в отдельную секцию.
- Дата и версия в заголовке корректны.
- Если нужен CHANGELOG.md в репо — содержимое вставлено (по отдельным запросам).
