AIKraft/Skills/VTEX IO: среда выполнения сервисов

VTEX IO: среда выполнения сервисов

Apply when designing or implementing the runtime structure of a VTEX IO backend app under node/. Covers the Service entrypoint, typed context and state, service.json runtime configuration, and how routes, events, and GraphQL handlers are registered and executed. Use for structuring backend apps, defining runtime boundaries, or fixing execution-model issues in VTEX IO services.

vtex official Дизайн

Что делает навык

Навык определяет архитектуру выполнения бэкенд-приложения VTEX IO внутри node-билдера, включая структуру точки входа Service, конфигурацию среды выполнения и регистрацию обработчиков. Он решает задачи по созданию и настройке runtime-окружения, типизации контекста и параметров, а также устранению проблем, связанных с моделью выполнения.

Когда применять

  • Создание нового бэкенд-приложения в директории node/
  • Структурирование файла node/index.ts как точки входа сервиса
  • Определение типизированных контрактов для Context, State и параметров обработчиков
  • Настройка service.json для параметров timeout, memory, workers и replicas
  • Решение проблем выполнения, вызванных несоответствием модели регистрации сервиса

Как работает

  1. Создать структуру приложения в директории node/ и определить node/index.ts как точку входа
  2. Настроить service.json, указав лимиты на timeout, память, количество workers и replicas
  3. Определить типизированные контракты для Context, State и параметров (params) для обработчиков
  4. Зарегистрировать HTTP-маршруты, события и обработчики GraphQL на уровне runtime
  5. Использовать отдельные навыки для проектирования схемы GraphQL, бизнес-логики событий и контрактов manifest.json

Примеры запросов агенту

Как правильно структурировать файл node/index.ts для новой сервисной точки входа в VTEX IO?
Настройте service.json для сервиса с лимитом памяти 512MB и таймаутом 30 секунд.
Как зарегистрировать обработчик GraphQL на уровне runtime, не затрагивая дизайн схемы?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «vtex-io-service-runtime» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-service-runtime/ ~/.claude/skills/vtex-io-service-runtime/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.