payment-provider-framework — скилл для Claude Code: установка
Скилл помогает проектировать и собирать платёжный коннектор VTEX IO. Он пригодится при настройке PPF, маршрутов, Secure Proxy и проверке сборки.
npx skills add vtex/skills --skill payment-provider-framework -a claude-codeЧто делает payment-provider-framework
Скилл разбирает реализацию Payment Connector как приложения VTEX IO: подключение @vtex/payment-provider, классы PaymentProvider, регистрацию маршрутов через PaymentProviderService и настройки configuration.json. Он также охватывает paymentProvider builder, retry для Gateway и связь с PSP.
Отдельно рассматриваются ExternalClient и SecureExternalClient, передача secureProxy в запросе авторизации, доступ к IOContext, response helpers и проверка платёжных аффилиаций. Для операций после авторизации карта не передаётся: запросы идут напрямую к PSP через ExternalClient с credentials и outbound-access policies.
В VTEX IO Builder Hub используется TypeScript 3.9.7, а skipLibCheck игнорируется. Поэтому современный синтаксис TypeScript или новые .d.ts в зависимостях могут сломать сборку ещё до проверки собственного кода.
Какие задачи решает
- спроектировать Payment Connector для VTEX IO
- подключить
PaymentProviderServiceи маршруты PPP - настроить
configuration.jsonиpaymentProviderbuilder - развести авторизацию через Secure Proxy и остальные запросы к PSP
- проверить сборку на ограничениях TypeScript 3.9.7
Примеры запросов агенту
- Спроектируй Payment Connector для VTEX IO через
PaymentProviderиPaymentProviderService. - Проверь
configuration.jsonиmanifest.jsonдля платёжного коннектора с Secure Proxy. - Разбери ошибку сборки VTEX IO, связанную с TypeScript 3.9.7 и зависимостями.
Как установить payment-provider-framework
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-framework -a claude-code2Вручную: положить файлы
~/.claude/skills/payment-provider-framework/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/payment-provider-framework/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-framework -a codex2Вручную: положить файлы
.agents/skills/payment-provider-framework/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-framework -a cursor2Вручную: положить файлы
.cursor/skills/payment-provider-framework/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills payment-provider-framework2Вручную: положить файлы
.github/skills/payment-provider-framework/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-framework -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/payment-provider-frameworkВручную: положить файлы
.devin/skills/payment-provider-framework/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-framework -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о payment-provider-framework
Как установить payment-provider-framework в Claude Code?
Выполните npx skills add vtex/skills --skill payment-provider-framework -a claude-code. После установки скилл находится по пути ~/.claude/skills/payment-provider-framework/SKILL.md.
Что делает payment-provider-framework?
Он помогает реализовать платёжный коннектор как приложение VTEX IO: настроить PPF, PaymentProvider, PaymentProviderService, конфигурацию, клиентов PSP и Secure Proxy.
Почему для этого скилла важен TypeScript 3.9.7?
Builder Hub компилирует приложения на TypeScript 3.9.7 и проверяет .d.ts из зависимостей, даже если в tsconfig.json включён skipLibCheck. Синтаксис из более новых версий TypeScript может сломать сборку.
