vtex-io-service-runtime — скилл для Claude Code: рантайм VTEX IO

Что делает vtex-io-service-runtime

Скилл включается, когда основная задача — как приложение работает внутри билдера node: структура точки входа Service, регистрация роутов, событий и GraphQL-обработчиков, объявление параметров исполнения. node/index.ts здесь считается корнем сборки рантайма, а не местом для бизнес-логики. Если в этом файле появляются вызовы внешних API, ветвления и преобразование данных, скилл советует вынести их в отдельные модули.

Настройки исполнения — timeout, memory, workers, minReplicas, maxReplicas, ttl, rateLimitPerReplica — живут в service.json, а не в коде обработчиков. Роуты по умолчанию приватные, поэтому для внешне доступных нужно явно ставить public: true. smartcache: true скилл разрешает только на идемпотентных роутах: на персонализированных, авторизованных и пишущих эндпоинтах кэш вернёт чужой ответ. ttl измеряется в минутах и не заменяет timeout.

Типы Context, State и параметров задаются так, чтобы ими пользовались и middleware, и обработчики — без сползания в any. Авторизационные поля вроде routes.access и routes.policies остаются за пределами этого скилла. Схему GraphQL и резолверы он тоже не проектирует, только регистрирует обработчики на уровне рантайма.