docs-changelog

Что делает навык

Навык стандартизирует обновление файлов changelog (latest.md, preview.md, index.md) на основе автоматизированной информации о релизе. Он обрабатывает версию, дату и сырые заметки, формируя сводки изменений и обновляя соответствующие файлы документации.

Когда применять

• Подготовка документации к стабильному выпуску (minor release) с обновлением index.md и latest.md.
• Обновление документации для превью-релизов (preview release) через редактирование preview.md.
• Внесение исправлений в документацию для патч-версий (patch release) путем добавления изменений в начало существующих списков.
• Автоматическая обработка сырых markdown-заметок о релизе, включая форматирование ссылок на PR и удаление секции новых участников.

Как работает

1. Проанализировать версию: если она содержит 'nightly', прекратить работу; иначе определить путь (A для версий, оканчивающихся на .0, или B для остальных).
2. Обработать входные данные: преобразовать время в форматы yyyy-mm-dd и Month dd, yyyy, сохранить сырые заметки во временный файл, переформатировать ссылки на PR и удалить секцию 'New Contributors'.
3. Для путей A.1 (стабильный minor) или A.2 (превью minor) сгенерировать анонс для index.md и заполнить шаблон (latest_template.md или preview_template.md) для соответствующего файла changelog.
4. Для путей B.1 (стабильный patch) или B.2 (превью patch) обновить заголовок и дату в целевом файле (latest.md или preview.md), добавить обработанные изменения в начало списка 'What's Changed' и обновить ссылку 'Full Changelog'.
5. Запустить команду npm run format для обеспечения согласованности кода (при необходимости выполнив npm install), затем удалить временные файлы.

Примеры запросов агенту

Что понадобится

• Доступ к файловой системе для чтения и записи файлов docs/changelogs/index.md, latest.md, preview.md.
• Наличие и доступность команд npm (npm install, npm run format) в окружении проекта.
• Доступ к шаблонам и примерам в директории .gemini/skills/docs-changelog/references/.

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.