AIKraft/Skills/VTEX IO: приложения конфигурации сервисов

VTEX IO: приложения конфигурации сервисов

Apply when designing VTEX IO configuration apps with the configuration builder or when a service app must receive structured configuration through runtime context. Covers the separation between service apps and configuration apps, schema.json and configuration.json, settingsType, and reading injected configuration through ctx.vtex.settings. Use for shared service configuration, decoupled configura

vtex official Дизайн

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

Навык применяется при проектировании конфигурационных приложений VTEX IO с использованием configuration builder или когда сервисное приложение получает структурированную конфигурацию через runtime-контекст. Он обеспечивает разделение между сервисными и конфигурационными приложениями, управление schema.json и configuration.json, а также чтение внедрённой конфигурации через ctx.vtex.settings.

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

  • Создание конфигурационного приложения с использованием configuration builder.
  • Предоставление точек входа для конфигурации из сервисного приложения.
  • Объединение единого контракта конфигурации для нескольких сервисов или приложений.
  • Разделение жизненного цикла конфигурации и жизненного цикла приложения во время выполнения.
  • Чтение внедрённой конфигурации через ctx.vtex.settings.

Как работает

  1. Определить необходимость передачи структурированной конфигурации от другого приложения через configuration builder, а не только через локальные настройки.
  2. Создать конфигурационное приложение с использованием configuration builder.
  3. Настроить schema.json и configuration.json для описания структуры конфигурации.
  4. Обеспечить доступ к конфигурации через ctx.vtex.settings в сервисном приложении.
  5. Разделить ответственность: конфигурационное приложение управляет данными, сервисное приложение использует их.

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

Как создать конфигурационное приложение с использованием configuration builder в VTEX IO?
Как прочитать внедрённую конфигурацию через ctx.vtex.settings в сервисном приложении?
Как разделить конфигурацию между несколькими сервисами в VTEX IO?

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

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

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

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