vtex-io-service-paths-and-cdn — скилл для Claude Code: пути и CDN
Помогает выбрать префикс пути в service.json и настроить Cache-Control так, чтобы кэш на edge не отдал чужие данные.
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-codeЧто делает vtex-io-service-paths-and-cdn
Скилл разбирает три варианта префикса для маршрутов VTEX IO: публичный, /_v/segment/ и /_v/private/. От выбора зависит, какие куки дойдут до сервиса и станет ли VTEX кэшировать ответ на edge. Публичный путь не гарантирует получение кук, сегментный отдаёт vtex_segment и кэшируется по сегменту, приватный добавляет vtex_session и не кэшируется вообще.
Внутри — правила решений, разбор частых ошибок и чек-лист для ревью. Скилл требует сначала классифицировать ответ (анонимный, сегментный, авторизованный), а уже потом назначать путь и заголовки. Если маршрут возвращает историю заказов, адреса или токены, публичный путь и длинный max-age — это утечка между покупателями. Обратите внимание: префикс пути и поле "public": true в service.json управляют разными вещами, их легко перепутать.
Для GraphQL-кэша на уровне полей нужен другой скилл, vtex-io-graphql-api, а для LRU, VBase и stale-while-revalidate — vtex-io-application-performance. Этот скилл про маршруты и заголовки ответа.
Какие задачи решает
- выбрать префикс пути под характер данных в ответе
- объяснить, почему маршрут не получает
vtex_session - согласовать
Cache-Controlс чувствительностью данных - разделить публичный каталог и приватные данные аккаунта на разные эндпоинты
- поймать кэширование персонального JSON на edge
Примеры запросов агенту
- Проверь маршруты в
service.jsonи скажи, какие из них отдают персональные данные на публичном пути - Помоги выбрать между
/_v/segment/и/_v/private/для эндпоинта с ценами по региону - Сверь
Cache-Controlв ответах с тем, что эти эндпоинты возвращают
Как установить vtex-io-service-paths-and-cdn
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-code2Вручную: положить файлы
~/.claude/skills/vtex-io-service-paths-and-cdn/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vtex-io-service-paths-and-cdn/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a codex2Вручную: положить файлы
.agents/skills/vtex-io-service-paths-and-cdn/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a cursor2Вручную: положить файлы
.cursor/skills/vtex-io-service-paths-and-cdn/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills vtex-io-service-paths-and-cdn2Вручную: положить файлы
.github/skills/vtex-io-service-paths-and-cdn/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/vtex-io-service-paths-and-cdnВручную: положить файлы
.devin/skills/vtex-io-service-paths-and-cdn/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о vtex-io-service-paths-and-cdn
Как установить vtex-io-service-paths-and-cdn в Claude?
Выполните npx skills add vtex/skills --skill vtex-io-service-paths-and-cdn -a claude-code. Файл скилла окажется в ~/.claude/skills/vtex-io-service-paths-and-cdn/SKILL.md.
Что делает vtex-io-service-paths-and-cdn?
Разбирает префиксы путей VTEX IO и их связь с куками и кэшированием на edge, а также помогает выставить Cache-Control под нужный уровень доступа к данным.
Чем этот скилл отличается от vtex-io-graphql-api?
Здесь речь о маршрутах service.json и заголовках ответа. Кэш на уровне полей GraphQL через @cacheControl разбирает отдельный скилл.
