headless-caching-strategy — скилл для Claude Code: настройка кэша
Задаёт правила кэширования для headless-витрин на VTEX. Помогает настроить CDN, BFF и стратегию stale-while-revalidate без утечки личных данных.
npx skills add vtex/skills --skill headless-caching-strategy -a claude-codeЧто делает headless-caching-strategy
Скилл регламентирует кэш в проектах на базе VTEX. Он разделяет публичные эндпоинты каталога и персональные интерфейсы покупателя. Без кэширования запросы быстро упираются в лимиты и вызывают ошибки 429. Сохранение ответов поиска и дерева категорий в CDN или памяти BFF снижает сетевые задержки на 200–500 мс.
Подход строится вокруг шаблона stale-while-revalidate и умеренных интервалов хранения от 2 до 15 минут. В правилах расписаны конкретные тайм-ауты: дерево категорий хранится до 15 минут, а поисковые подсказки устаревают через пару минут. Сбрасывать устаревшие данные скилл рекомендует по событиям изменения каталога, а не длинными статическими TTL.
Кэширование корзины или профиля ломает магазин и открывает доступ к чужим персональным данным. Поэтому эндпоинты Checkout, Profile, OMS и Payments запрещено сохранять на любом уровне, включая Redis и CDN.
Какие задачи решает
- защитить API VTEX от исчерпания лимитов при частых запросах каталога
- внедрить логику stale-while-revalidate на уровне собственного BFF
- задать безопасные интервалы TTL для публичных поисковых маршрутов
- заблокировать кэширование личных данных покупателей и состояния корзины
Примеры запросов агенту
- Настрой кэширование в Express BFF для эндпоинта дерева категорий VTEX с логикой stale-while-revalidate.
- Какие значения TTL и заголовки ответа задать для Intelligent Search?
- Проверь маршруты BFF и убедись, что Checkout и Profile нигде не кэшируются.
Как установить headless-caching-strategy
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-caching-strategy -a claude-code2Вручную: положить файлы
~/.claude/skills/headless-caching-strategy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/headless-caching-strategy/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-caching-strategy -a codex2Вручную: положить файлы
.agents/skills/headless-caching-strategy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-caching-strategy -a cursor2Вручную: положить файлы
.cursor/skills/headless-caching-strategy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills headless-caching-strategy2Вручную: положить файлы
.github/skills/headless-caching-strategy/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-caching-strategy -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/headless-caching-strategyВручную: положить файлы
.devin/skills/headless-caching-strategy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-caching-strategy -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о headless-caching-strategy
Как установить headless-caching-strategy в Claude Code?
Выполните команду npx skills add vtex/skills --skill headless-caching-strategy -a claude-code. Агент сохранит файл навыка в ~/.claude/skills/headless-caching-strategy/SKILL.md.
Какие эндпоинты VTEX скилл запрещает кэшировать?
Запрет действует на Checkout (/api/checkout/), Profile (/api/profile-system/pvt/), OMS (/api/oms/pvt/orders), Payments (/api/payments/) и приватные цены. Кэш на этих маршрутах приводит к утечке персональных данных и сбоям в расчётах заказов.
Для каких задач этот скилл не подходит?
Скилл не решает вопросы общей архитектуры BFF, маршрутизации запросов или тонкостей интеграции Intelligent Search. Для них у VTEX есть отдельные навыки: headless-bff-architecture и headless-intelligent-search.
