AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: версионирование темы витрины

VTEX IO: версионирование темы витрины

Apply when installing, publishing, upgrading, or rolling back a VTEX IO storefront theme app (`vendor.store-theme` or any app that owns `store/blocks.json`, `store/routes.json`, and `store/contentSchemas.json`). Covers how Site Editor and theme content are scoped by the app's MAJOR version, why a major version bump leaves the new major with no merchant content and silently falls back to default th

vtex official Другое

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

Навык описывает процесс версионирования, установки, публикации и отката приложения-темы витрины (storefront), владеющего файлами store/blocks.json, store/routes.json и store/contentSchemas.json. Он объясняет механизм привязки Site Editor и контента к MAJOR-версии приложения, а также причины потери контента при повышении мажорной версии или откате на тему по умолчанию.

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

  • Изменение версии приложения-темы с помощью команды vtex release patch | minor | major.
  • Выполнение команд vtex publish или vtex deploy для приложения-темы.
  • Установка конкретной версии темы в продакшн-аккаунт через vtex install vendor.store-theme@X.Y.Z.
  • Планирование восстановления контента витрины после деплоя, который привел к потере данных.
  • Обзор скриптов развертывания разработчика, которые затрагивают тему витрины.

Как работает

  1. Определить, является ли приложение темой витрины, владеющей файлами store/blocks.json, store/routes.json, store/templates/ или store/contentSchemas.json.
  2. Учесть, что контент темы и Site Editor привязаны к MAJOR-версии приложения.
  3. При повышении мажорной версии (major) понять, что новая версия не будет содержать мерчантский контент.
  4. При откате на тему по умолчанию или смене мажорной версии оценить риск потери контента.
  5. Использовать навыки vtex-io-render-runtime-and-blocks, vtex-io-storefront-react, vtex-io-app-settings или vtex-io-masterdata-strategy для задач, не связанных с версионированием темы.

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

Как правильно обновить версию темы vendor.store-theme, чтобы не потерять контент?
Почему после деплоя темы пропал весь контент из Site Editor?
Как откатить тему витрины к предыдущей мажорной версии?

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

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

1Скачать навык
# возьмите папку навыка «vtex-io-storefront-theme-versioning» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-storefront-theme-versioning/ ~/.claude/skills/vtex-io-storefront-theme-versioning/

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