vtex-io-session-apps — скилл для Claude Code
Скилл vtex-io-session-apps для разработки и отладки session transform приложений VTEX IO, которые вычисляют состояние сессии для витрины, ценообразования и чекаута.
лицензия не указана 1 200 установок ★ 47 обновлён 2026-10-14
npx skills add vtex/skills --skill vtex-io-session-apps -a claude-codeЧто делает vtex-io-session-apps
Скилл применяется при интеграции с системой сессий VTEX (vtex.session): объясняет, как приложение объявляет входные и выходные поля в configuration.json, как VTEX строит граф зависимостей (DAG) между трансформами, и когда один трансформ перезапускается из-за изменения другого. Покрывает разделение public.* (входная поверхность для намерений пользователя) и приватных пространств имён (profile, storefront-permissions, checkout) как модели чтения для фронтенда.
Скилл запрещает дублировать чужие выходные поля: если storefront-permissions владеет costcenter, ваш трансформ должен читать это поле как вход, а не писать свою копию. Без account и workspace в ключах LRU-кеша трансформ вернёт данные чужого воркспейса. Для пропагации значений в нативные трансформы обновляйте их входные поля (public.postalCode), а не переписывайте прямо checkout.postalCode.
Скилл рассчитан на VTEX IO и сценарии B2B, где storefront-permissions, кастомные трансформы и чекаут взаимодействуют через сессию.
Какие задачи решает
- описать входы и выходы session transform в
configuration.json - прочитать
storefront-permissions.costcenterи вычислитьmyapp.priceTable - обновить
public.postalCode, чтобы перезапуститьcheckouttransform - закешировать запрос к внешнему бэкенду через VBase stale-while-revalidate
- запросить конкретные поля сессии на фронтенде через
items=rona.storeNumber
Примеры запросов агенту
- Напиши session transform для VTEX IO, который читает
storefront-permissions.organizationи выводитmyapp.storeNumber - Объясни, почему мой transform запускается дважды при изменении
public.country - Покажи
configuration.jsonдля трансформа, который зависит отprofileиstorefront-permissions
Как установить vtex-io-session-apps
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-session-apps -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-session-apps/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-session-apps/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-session-apps -a codex2Вручную: положить файлы
.agents/skills/vtex-io-session-apps/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-session-apps -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-session-apps/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills skills/vtex-io-session-apps2Вручную: положить файлы
.github/skills/vtex-io-session-apps/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-session-apps -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-session-appsВручную: положить файлы
.devin/skills/vtex-io-session-apps/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-session-apps -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-session-apps
Как установить vtex-io-session-apps в Claude Code?
Выполните npx skills add vtex/skills --skill vtex-io-session-apps -a claude-code, затем откройте ~/.claude/skills/vtex-io-session-apps/SKILL.md.
Что делает vtex-io-session-apps?
Скилл помогает разрабатывать session transform приложения для VTEX IO: объясняет граф зависимостей (DAG), разделение входов и выходов, владение пространствами имён и правила кеширования внутри трансформов.
Почему нельзя дублировать поля другого приложения в своём namespace?
Копирование полей вроде costcenter из storefront-permissions в ваше пространство создаёт два источника правды. При частичном обновлении сессии потребители читают разные значения, и возникают гонки.