Клиентский навык (Agent Skills), который ведёт пользователя по интеграции с платёжной системой Prodamus: от брифа и проектирования до боевого запуска и передачи наработок в каталог интеграций.
Навык предоставляется клиентам и интеграторам Prodamus бесплатно.
Версия 1.0.
- Определяет профиль пользователя (разработчик платформы / интегратор / мерчант без разработки) и подстраивает глубину.
- Сам собирает информацию о системе пользователя и проверяет, нет ли уже готовой интеграции в каталоге.
- Помогает выбрать функции интеграции (свободная/фиксированная сумма, подписки, рассрочка, скидки, маркировка…) и порядок их реализации.
- Проектирует интеграцию (тип, режим оплаты do=link / do=pay / виджет, схема данных) и согласует короткую спеку.
- Раз в неделю сверяет каталог функций и интеграций с живой документацией help.prodamus.ru.
- Подбирает SYS-идентификатор и готовит заявку в поддержку Prodamus (MAX или ВКонтакте).
- Ведёт разработку с тестами: канонический HMAC с тест-векторами, генерация ссылок, приём webhook, идемпотентность.
- Проверяет готовность по чек-листу с доказательствами и прогоном в demo_mode, сопровождает боевой запуск.
- Готовит пакет для публикации в каталоге Prodamus.
Прогресс хранится в .prodamus/STATE.md проекта пользователя — работу можно
прервать и продолжить в новой сессии.
Внешних зависимостей у навыка нет: всё, что нужно для работы, лежит внутри папки навыка.
Скопируйте папку prodamus-integration-expert/ в скиллы:
# для одного проекта
cp -r prodamus-integration-expert /path/to/project/.claude/skills/
# или глобально для всех проектов
cp -r prodamus-integration-expert ~/.claude/skills/Затем в Claude Code: /prodamus-integration-expert или просто попросите
«помоги с интеграцией Prodamus».
Упакуйте папку в zip и загрузите как Skill (Settings → Capabilities → Skills):
cd prodamus-integration-expert && zip -r ../prodamus-integration-expert.zip . && cd ..prodamus-integration-expert/
├─ SKILL.md # оркестратор: онбординг (фаза 0), режимы
│ # марафон/точечный вход, роутинг фаз,
│ # свежесть данных (сверка раз в неделю),
│ # железные правила
├─ phases/
│ ├─ 01-discovery.md # бриф: сбор информации самостоятельно,
│ │ # проверка каталога готовых интеграций,
│ │ # вопросы только по пробелам
│ ├─ 02-features.md # выбор функций интеграции и порядка их
│ │ # реализации (MVP → остальное)
│ ├─ 03-design.md # тип интеграции, режим оплаты, схема
│ │ # данных — решает ИИ, пользователь
│ │ # одобряет короткую спеку
│ ├─ 04-sys.md # подбор SYS-идентификатора, заявка в
│ │ # поддержку Prodamus, реквизиты
│ ├─ 05-plan.md # пошаговый план с проверяемыми
│ │ # результатами, порядок — по приоритету
│ │ # функций
│ ├─ 06-build.md # разработка (TDD): HMAC → ссылка →
│ │ # webhook → отражение оплаты → функции
│ ├─ 07-verify.md # чек-лист готовности (11 пунктов) с
│ │ # доказательствами + прогон в demo_mode
│ ├─ 08-launch.md # боевой запуск: реквизиты, smoke-тест,
│ │ # журналирование, план отката
│ └─ 09-catalog.md # пакет наработок и передача в каталог
│ # через поддержку Prodamus
├─ references/
│ ├─ payform-protocol.md # протокол Payform: do=link / do=pay,
│ │ # параметры, webhook-контракт, 54-ФЗ,
│ │ # REST-эндпоинты, домены payform
│ ├─ hmac.md # подписи: две схемы, канонический HMAC,
│ │ # эталонный код PHP / Python / Node.js,
│ │ # тест-вектора, типичные ошибки
│ ├─ features.md # каталог функций Prodamus с датой
│ │ # последней сверки (обновляется
│ │ # еженедельно по живой документации)
│ ├─ dev-practices.md # дисциплина разработки: бриф и дизайн до
│ │ # кода, планы, TDD, верификация, разбор
│ │ # инцидентов — с красными флагами
│ ├─ architecture-patterns.md # структура проекта, слои, журнал обмена,
│ │ # идемпотентность, мультитенантность,
│ │ # страница ожидания
│ ├─ security-checklist.md # обязательные требования безопасности
│ │ # (10 пунктов, не упрощаются)
│ ├─ profiles.md # адаптация под профиль пользователя и
│ │ # среду (Claude Code / чат без ФС)
│ └─ help-prodamus-map.md # карта публичной документации
│ # help.prodamus.ru и каталога интеграций
└─ templates/
├─ state.md # шаблон .prodamus/STATE.md: фазы,
│ # функции, реквизиты, verify, launch
├─ brief.md # шаблон брифа интеграции
├─ sys-request.md # шаблон заявки на SYS в поддержку
└─ catalog-package.md # шаблон пакета для каталога + чек-лист
В проекте пользователя навык создаёт рабочие файлы:
.prodamus/
├─ STATE.md # трекинг фаз, функций, реквизитов и доказательств
├─ BRIEF.md # бриф (фаза 1)
├─ SPEC.md # спека интеграции (фаза 3)
├─ PLAN.md # план работ с чекбоксами (фаза 5)
└─ DATA-UPDATES.md # расхождения с живой документацией (если файлы
# навыка недоступны на запись)
- Публичная документация Prodamus: https://help.prodamus.ru/
- Каталог интеграций: https://help.prodamus.ru/payform/integracii
- Поддержка Prodamus — выдача SYS-идентификатора и приём пакетов в каталог: бот в MAX https://max.ru/id1215156909_2_bot или сообщество ВКонтакте https://vk.ru/prodamuspay