add-to-changelog — команда для Claude Code: запись в CHANGELOG.md
Добавляет запись в CHANGELOG.md по формату Keep a Changelog: версия, тип изменения, текст. Пригодится, когда релиз близко, а раздел в файле всё ещё пустой.
npx claude-code-templates@latest --command project-management/add-to-changelogЧто делает add-to-changelog
Команда принимает три аргумента: версию, тип изменения и сообщение. Тип — один из added, changed, deprecated, removed, fixed, security. Если файла CHANGELOG.md нет, он создаётся со стандартной шапкой. Дальше команда ищет или создаёт секцию нужной версии с сегодняшней датой и кладёт запись в подходящий раздел.
Есть и короткая форма: флаги --added, --changed, --fixed. Внутри команда читает CHANGELOG.md, а также package.json или setup.py, если они есть в проекте. Поэтому при новой версии она обновит и файл с версией пакета. Для этого ей выдан доступ к Read, Write, Edit и Bash.
Проверьте, что номер версии в аргументе совпадает с тем, что вы реально собираетесь выпустить: команда запишет в package.json именно его. Формат ведения changelog команда не пересматривает — если в вашем файле своя структура, запись встанет по её правилам, а не по вашей.
Какие задачи решает
- записать изменение в CHANGELOG.md, не открывая файл руками
- создать CHANGELOG.md с нуля по формату Keep a Changelog
- разложить записи по разделам added, changed, fixed и другим
- поднять версию в package.json или setup.py вместе с записью
- зафиксировать дату релиза в секции версии
Примеры запросов агенту
- /add-to-changelog 1.1.0 added "Новая конвертация markdown в BlockDoc"
- /add-to-changelog 1.0.2 fixed "Ошибка в HTML-рендерере"
- /add-to-changelog --changed "Переписал слой доступа к данным"
Как установить add-to-changelog
1Через claude-code-templates
npx claude-code-templates@latest --command project-management/add-to-changelog2Вручную: положить файлы
.claude/commands/add-to-changelog.mdВызов — /add-to-changelog. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/add-to-changelog.mdВызов — /prompts:add-to-changelog. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/add-to-changelog.prompt.mdВручную: положить файлы
.gemini/commands/add-to-changelog.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о add-to-changelog
Как установить add-to-changelog в Claude?
Выполните npx claude-code-templates@latest --command project-management/add-to-changelog. Файл команды появится по пути .claude/commands/add-to-changelog.md.
Что делает add-to-changelog?
Добавляет запись в CHANGELOG.md: создаёт файл при необходимости, находит или создаёт секцию версии с датой и кладёт текст в раздел нужного типа изменения.
Какие аргументы принимает команда?
Версию, тип изменения и сообщение, например /add-to-changelog 1.1.0 added "текст". Вместо типа можно передать флаг --added, --changed или --fixed.
Исходный текст
add-to-changelog.md · MIT
--- allowed-tools: Read, Write, Edit, Bash argument-hint: "[version] [change-type] [message] | --added | --changed | --fixed" description: Add entry to project changelog following Keep a Changelog format --- # Update Changelog Add a new entry to the project's CHANGELOG.md file: **$ARGUMENTS** ## Usage Examples - `/add-to-changelog 1.1.0 added "New markdown to BlockDoc conversion feature"` - `/add-to-changelog 1.0.2 fixed "Bug in HTML renderer causing incorrect output"` ## Current Changelog State - Existing changelog: @CHANGELOG.md (if exists) - Project version files: @package.json or @setup.py (if exists) ## Task Add the specified change entry to CHANGELOG.md: **Arguments**: - Version: First argument (e.g., "1.1.0") - Change Type: Second argument (added/changed/deprecated/removed/fixed/security) - Message: Third argument (description of the change) **Requirements**: 1. Create CHANGELOG.md with standard header if it doesn't exist 2. Find or create version section with today's date 3. Add entry under appropriate change type section 4. Follow Keep a Changelog format and Semantic Versioning 5. Update package version files if this is a new version The changelog should follow [Keep a Changelog](https://keepachangelog.com/) format.
© davila7 · MIT · davila7/claude-code-templates