# changelog-generator

Субагент собирает CHANGELOG.md и заметки к релизу из коммитов, разбирая их по Conventional Commits. Пригодится перед выкаткой версии.

- субагент · `type=agent` · Claude Code · 1754 установки
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/documentation/changelog-generator.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/changelog-generator

## Что делает

Субагент читает историю git и раскладывает изменения по группам: ломающие, новые возможности, исправления, внутренние правки. Разбор идёт по Conventional Commits, поэтому коммиты без внятного префикса в аккуратную сводку не попадут. Ломающие изменения и миграции он ставит в начало.

Инструменты у него простые: `Read`, `Write`, `Edit` и `Bash`. То есть он сам вызывает git, пишет файлы и правит уже существующий `CHANGELOG.md`. Формат вывода — Keep a Changelog, с датами и ссылками на версии. Кроме самого changelog он готовит заметки к релизу с ссылками на скачивание, руководства по миграции и скрипты для автоматической генерации.

Автор закладывает ручную доводку: генерацию стоит автоматизировать, но содержимое просматривать. Для проекта без дисциплины в сообщениях коммитов пользы будет мало — сначала придётся договориться о шаблоне.

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent documentation/changelog-generator
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/changelog-generator.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/changelog-generator.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/changelog-generator.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/documentation/changelog-generator.md

## Когда брать
- собрать CHANGELOG.md из истории коммитов
- написать заметки к релизу с акцентом на то, что заметит пользователь
- описать миграцию при ломающих изменениях
- разложить коммиты по категориям и важности
- завести шаблон сообщений коммитов и правила релиза

## Примеры запросов агенту
- Собери CHANGELOG.md из коммитов за последний релиз
- Сделай заметки к версии 2.0 и вынеси ломающие изменения наверх
- Напиши руководство по миграции для изменений из последних коммитов

## Похожие
- [changelog-automation](https://affpapa.org/nevibecode/skills/changelog-automation.md) — скилл · 13733 установки
- [deployment-engineer](https://affpapa.org/nevibecode/agents/deployment-engineer.md) — субагент · 6079 установок
- [launchdarkly-flag-cleanup](https://affpapa.org/nevibecode/agents/launchdarkly-flag-cleanup.md) — субагент · 171 установка
- [pr-test-analyzer](https://affpapa.org/nevibecode/agents/pr-test-analyzer.md) — субагент · ★ 44770
- [Technical Debt Remediation Plan](https://affpapa.org/nevibecode/agents/technical-debt-remediation-plan.md) — субагент · ★ 40451
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — субагент · ★ 40451

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md