vtex-io-storefront-theme-versioning — скилл для Claude Code
Инструктирует агента по обновлению, публикации и откату тем оформления в VTEX IO без потери контента из Site Editor при смене мажорной версии.
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a claude-codeЧто делает vtex-io-storefront-theme-versioning
Скилл задаёт правила версионирования для приложений с файлами store/blocks.json, store/routes.json и store/templates/. Платформа VTEX IO привязывает данные редактора Site Editor к ключам с номером мажорной версии ([email protected]:template). При переходе на новую мажорную версию привязка сбрасывается. Витрина начинает показывать стандартный шаблон VTEX, теряя все пользовательские настройки страниц.
Агент направляет работу по безопасному маршруту: подготовка отдельного воркспейса командой vtex use rollout-workspace --production, установка приложения и перенос контента мутацией updateThemeIds в сервисе [email protected]. Прогон через GraphQL Admin IDE меняет привязку страниц и редиректов до релиза. Без вызова этой мутации промоут воркспейса в master оставит магазин без наполнения.
Скилл также учитывает логику слияния при вызове vtex workspace promote. Сервер применяет стратегию «mine wins» и при конфликтах сохраняет ежеминутные копии в хранилище userData_backup. Это снижает риск затереть правки мерчанта в мастере.
Какие задачи решает
- предотвратить потерю наполнения Site Editor при релизе новой мажорной версии темы
- перенести страницы и редиректы между версиями через мутацию
updateThemeIds - проверить тему в изолированном продакшен-воркспейсе перед промоутом в
master - спланировать откат темы на предыдущую мажорную версию без ручного ввода данных
Примеры запросов агенту
- Подскажи план безопасного релиза темы
acme.store-themeс версии 1.x на 2.x в VTEX IO. - Как запустить мутацию
updateThemeIdsдля переноса страниц из мажорной версии 0 в 1? - Проверь скрипт деплоя темы витрины перед выполнением
vtex workspace promote.
Как установить vtex-io-storefront-theme-versioning
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-storefront-theme-versioning/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-storefront-theme-versioning/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a codex2Вручную: положить файлы
.agents/skills/vtex-io-storefront-theme-versioning/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-storefront-theme-versioning/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-storefront-theme-versioning2Вручную: положить файлы
.github/skills/vtex-io-storefront-theme-versioning/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-storefront-theme-versioningВручную: положить файлы
.devin/skills/vtex-io-storefront-theme-versioning/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-storefront-theme-versioning
Как установить vtex-io-storefront-theme-versioning в Claude Code?
Выполните команду npx skills add vtex/skills --skill vtex-io-storefront-theme-versioning -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/vtex-io-storefront-theme-versioning/SKILL.md.
Почему при смене мажорной версии темы пропадает контент?
Сервис vtex.pages-graphql хранит данные Site Editor под ключом с указанием мажорной версии. Новая мажорная версия обращается к пустому ключу и откатывается на стандартные шаблоны VTEX.
Для чего нужен запуск мутации updateThemeIds?
Она переносит сохранённые правки Site Editor, маршруты и редиректы со старого мажорного ключа на новый в рамках одной операции через GraphQL Admin IDE.
