headless-bff-architecture — скилл для Claude Code
Помогает спроектировать BFF для headless-витрины VTEX и закрыть доступ браузера к приватным API и секретам.
npx skills add vtex/skills --skill headless-bff-architecture -a claude-codeЧто делает headless-bff-architecture
Скилл задаёт архитектуру BFF для headless-проектов на VTEX. Он помогает разделить публичные и приватные API, направить вызовы через серверный прокси и защитить запросы к Checkout, OMS и Profile. Intelligent Search остаётся единственным API, который можно вызывать напрямую из браузера.
Для запросов от имени покупателя скилл требует хранить VtexIdclientAutCookie в серверной сессии, а не в localStorage или sessionStorage. Для машинных вызовов используются X-VTEX-API-AppKey и X-VTEX-API-AppToken; ключи советуется разделять по модулям BFF и выдавать им минимальные права. Публичные /pub/ маршруты тоже обычно проходят через BFF, а /pvt/ и публичный Checkout должны проксироваться обязательно. Без серверного BFF приватные вызовы из браузера нарушают требования безопасности.
Какие задачи решает
- спроектировать BFF для headless-витрины VTEX
- разделить публичные и приватные API VTEX
- убрать секреты из браузерного кода
- организовать серверное хранение
VtexIdclientAutCookie - проверить проксирование Checkout и
/pvt/маршрутов
Примеры запросов агенту
- Спроектируй BFF для headless-витрины VTEX и классифицируй её API.
- Проверь код проекта: найди прямые вызовы
/pvt/и работу сVtexIdclientAutCookieв браузере. - Предложи схему серверной сессии и раздельных API-ключей для модулей BFF.
Как установить headless-bff-architecture
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-bff-architecture -a claude-code2Вручную: положить файлы
~/.claude/skills/headless-bff-architecture/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/headless-bff-architecture/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-bff-architecture -a codex2Вручную: положить файлы
.agents/skills/headless-bff-architecture/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-bff-architecture -a cursor2Вручную: положить файлы
.cursor/skills/headless-bff-architecture/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills headless-bff-architecture2Вручную: положить файлы
.github/skills/headless-bff-architecture/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-bff-architecture -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/headless-bff-architectureВручную: положить файлы
.devin/skills/headless-bff-architecture/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-bff-architecture -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о headless-bff-architecture
Как установить headless-bff-architecture в Claude Code?
Выполните npx skills add vtex/skills --skill headless-bff-architecture -a claude-code, затем проверьте файл ~/.claude/skills/headless-bff-architecture/SKILL.md.
Что делает headless-bff-architecture?
Скилл помогает проектировать BFF для headless-витрины VTEX, классифицировать API и проксировать приватные запросы через сервер. Он также задаёт правила для API-ключей и VtexIdclientAutCookie.
Можно ли вызывать API VTEX напрямую из браузера?
Напрямую допускается вызывать только Intelligent Search. Приватные /pvt/ маршруты и публичные Checkout API должны идти через BFF.
