masterdata-storage-strategy — скилл для Claude Code: установка
Скилл помогает выбрать хранилище данных в экосистеме VTEX и составить JSON-схему для Master Data с правильными индексами, кешем и правами доступа.
npx skills add vtex/skills --skill masterdata-storage-strategy -a claude-codeЧто делает masterdata-storage-strategy
Скилл задаёт правила выбора хранилища перед созданием сущностей в платформе VTEX. Он подсказывает, когда документоориентированная база Master Data оправдана, а когда данные нужно вынести в Catalog, OMS, VBase или внешнюю SQL-базу. Решение не подходит для критичных к задержкам сценариев вроде оформления заказа: Master Data не обеспечивает отклик быстрее 10 миллисекунд.
Внутри собраны рекомендации по настройке VTEX-расширений JSON Schema: массива v-indexed, флага кеширования v-cache, списка полей по умолчанию v-default-fields и политик v-security. Индексировать стоит только поля из условий фильтрации where. Каждый лишний индекс замедляет запись и раздувает объём хранилища.
Для написания клиентского кода VTEX IO этот скилл не предназначен: правила интеграции вынесены в отдельные навыки репозитория.
Какие задачи решает
- выбрать между Master Data, VBase, Catalog и внешней базой данных
- составить JSON-схему сущности с параметрами
v-indexedиv-security - настроить кеширование документов через
v-cacheпод профиль нагрузки - провести аудит существующих сущностей и убрать избыточные индексы
Примеры запросов агенту
- Помоги составить JSON-схему для сущности отзывов в VTEX Master Data
- Проверь, подходит ли Master Data для хранения временных корзин пользователей
- Какие поля нужно добавить в
v-indexedдля таблицы списка желаний?
Как установить masterdata-storage-strategy
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill masterdata-storage-strategy -a claude-code2Вручную: положить файлы
~/.claude/skills/masterdata-storage-strategy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/masterdata-storage-strategy/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill masterdata-storage-strategy -a codex2Вручную: положить файлы
.agents/skills/masterdata-storage-strategy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill masterdata-storage-strategy -a cursor2Вручную: положить файлы
.cursor/skills/masterdata-storage-strategy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills masterdata-storage-strategy2Вручную: положить файлы
.github/skills/masterdata-storage-strategy/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill masterdata-storage-strategy -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/masterdata-storage-strategyВручную: положить файлы
.devin/skills/masterdata-storage-strategy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill masterdata-storage-strategy -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о masterdata-storage-strategy
Как установить masterdata-storage-strategy в Claude Code?
Выполните команду npx skills add vtex/skills --skill masterdata-storage-strategy -a claude-code. Файл навыка будет сохранён по пути ~/.claude/skills/masterdata-storage-strategy/SKILL.md.
Для чего нужен этот скилл?
Он помогает разработчикам выбрать подходящую систему хранения в VTEX и спроектировать схему данных без лишней нагрузки на запись.
Когда вместо Master Data нужно использовать внешнюю базу данных?
Внешняя база необходима при миллионах записей в день, потребности в реляционных связях через join или требованиях к строгой согласованности данных.
