AIKraft/Skills/VTEX IO: контракт приложения

VTEX IO: контракт приложения

Apply when defining or changing the contract of a VTEX IO app through manifest.json, builder declarations, dependencies, peerDependencies, billingOptions, and app identity. Covers how the app declares capabilities and integration boundaries. Use for scaffolding apps, splitting responsibilities across apps, or fixing contract-level link and publish issues.

vtex official Другое

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

Навык определяет контракт приложения VTEX IO через manifest.json, включая декларации builder'ов, зависимостей и идентичность. Он охватывает вопросы декларируемых возможностей, границ интеграции и разделения ответственности между приложениями.

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

  • Создание нового приложения VTEX IO и определение его начального контракта
  • Добавление или удаление builder'ов для соответствия возможностям приложения
  • Выбор между использованием dependencies и peerDependencies
  • Решение о том, принадлежит ли возможность текущему приложению или должна быть перенесена в другое
  • Устранение проблем при link или publish, вызванных ошибками в контракте на уровне manifest

Как работает

  1. Проанализировать текущий manifest.json для оценки декларируемых возможностей и границ интеграции
  2. Определить, какие builder'ы необходимы для реализации заявленных возможностей, и добавить или удалить их
  3. Выбрать правильный тип зависимости (dependencies или peerDependencies) для внешних модулей
  4. Оценить, должна ли конкретная функциональность оставаться в текущем приложении или быть выделена в отдельное
  5. Проверить manifest.json на соответствие требованиям платформы для устранения ошибок при link или publish

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

Как правильно настроить manifest.json для нового приложения VTEX IO?
Как определить, нужно ли выносить функциональность в отдельное приложение или оставить в текущем?
Почему возникает ошибка при publish, и как исправить контракт в manifest.json?

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

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

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

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