changelog-generator — субагент для Claude Code
Субагент собирает CHANGELOG.md и заметки к релизу из коммитов, разбирая их по Conventional Commits. Пригодится перед выкаткой версии.
npx claude-code-templates@latest --agent documentation/changelog-generatorЧто делает changelog-generator
Субагент читает историю git и раскладывает изменения по группам: ломающие, новые возможности, исправления, внутренние правки. Разбор идёт по Conventional Commits, поэтому коммиты без внятного префикса в аккуратную сводку не попадут. Ломающие изменения и миграции он ставит в начало.
Инструменты у него простые: Read, Write, Edit и Bash. То есть он сам вызывает git, пишет файлы и правит уже существующий CHANGELOG.md. Формат вывода — Keep a Changelog, с датами и ссылками на версии. Кроме самого changelog он готовит заметки к релизу с ссылками на скачивание, руководства по миграции и скрипты для автоматической генерации.
Автор закладывает ручную доводку: генерацию стоит автоматизировать, но содержимое просматривать. Для проекта без дисциплины в сообщениях коммитов пользы будет мало — сначала придётся договориться о шаблоне.
Какие задачи решает
- собрать CHANGELOG.md из истории коммитов
- написать заметки к релизу с акцентом на то, что заметит пользователь
- описать миграцию при ломающих изменениях
- разложить коммиты по категориям и важности
- завести шаблон сообщений коммитов и правила релиза
Примеры запросов агенту
- Собери CHANGELOG.md из коммитов за последний релиз
- Сделай заметки к версии 2.0 и вынеси ломающие изменения наверх
- Напиши руководство по миграции для изменений из последних коммитов
Как установить changelog-generator
1Через claude-code-templates
npx claude-code-templates@latest --agent documentation/changelog-generator2Вручную: положить файлы
.claude/agents/changelog-generator.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/changelog-generator.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/changelog-generator.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о changelog-generator
Как установить changelog-generator в Claude Code?
Запусти npx claude-code-templates@latest --agent documentation/changelog-generator, файл появится по пути .claude/agents/changelog-generator.md.
Что делает changelog-generator?
Генерирует changelog и заметки к релизу из git-истории, группирует изменения по влиянию на пользователя и готовит руководства по миграции.
Какие инструменты доступны субагенту?
Read, Write, Edit и Bash — этого хватает, чтобы читать репозиторий, вызывать git и писать файлы.
