Бэкенд
Prismatic Skills
prismatic-io/prismatic-skillsПлагин для Claude Code, позволяющий разрабатывать кастомные компоненты и code-native интеграции на платформе Prismatic.io. Поддерживает генерацию кода, деплой, работу с GraphQL API и управление окружением через чат.
Установка
terminal
bash
git clone https://github.com/prismatic-io/prismatic-skills.gitREADME
Prismatic Skills
Плагин Claude Code для создания и управления интеграциями Prismatic через диалог. Разрабатывайте кастомные компоненты, генерируйте Code Native Integrations, исследуйте своё окружение Prismatic и управляйте платформой — прямо из редактора.
Предварительные требования
- Prism CLI: Установите через
npm install -g @prismatic-io/prism(также включает встроенный MCP-сервер) - Аккаунт Prismatic: Активный аккаунт с правами на интеграции и компоненты
- Node.js 18+: Требуется для скриптов воркфлоу (запускаются через
tsx) - Claude Code: CLI или расширение с поддержкой плагинов
Установка
Добавьте маркетплейс и установите плагин в Claude Code:
bash
/plugin marketplace add prismatic-io/prismatic-skills
/plugin install prismatic-skills@prismatic-skillsРазработка / Тестирование
Для локальной разработки загрузите плагин напрямую:
claude --plugin-dir /path/to/prismatic-skills
Доступные команды
/prismatic-skills:build-component
Сборка и деплой кастомного компонента Prismatic.
/prismatic-skills:build-component Canny API connector
Воркфлоу:
- Настройка — Проверка Prism CLI и аутентификации
- Требования — Интерактивный опросник (тип компонента, детали API)
- Исследование API — Для коннекторов: анализ внешнего API
- Скаффолдинг — Генерация структуры компонента через Prism CLI
- Генерация кода — Реализация actions, triggers, connections
- Сборка и публикация — Компиляция и деплой в Prismatic
/prismatic-skills:build-integration
Сборка и деплой Code Native Integration (CNI) для Prismatic.
/prismatic-skills:build-integration Salesforce to Slack sync
Воркфлоу:
- Настройка — Проверка Prism CLI и аутентификации
- Требования — Интерактивный опросник (системы, триггеры, потоки данных)
- Сбор учётных данных — Получение OAuth/API-credentials при необходимости
- Скаффолдинг — Генерация структуры проекта с манифестами компонентов
- Генерация кода — Создание TypeScript-файлов (flows, config pages и др.)
- Сборка, деплой и тестирование — Компиляция, деплой и тестирование flows
- Итерации — Исправление ошибок, пересборка, повторный деплой
/prismatic-skills:orby
Обратитесь к Orby — гиду по платформе Prismatic — чтобы исследовать окружение или выполнить операции на платформе.
/prismatic-skills:orby What integrations do I have?
/prismatic-skills:orby Deploy the Slack integration to Acme Corp
/prismatic-skills:orby How do I query execution logs in GraphQL?
/prismatic-skills:orby Show me the last 10 failed executions
Возможности:
- Исследование окружения — Просмотр компонентов, интеграций, инстансов, клиентов и выполнений
- Операции на платформе — Деплой интеграций, управление инстансами, создание клиентов
- Построение GraphQL-запросов — Формирование и выполнение запросов к Prismatic API
- Поиск по документации — Поиск и получение контента с prismatic.io/docs
- Оркестрация воркфлоу — Многошаговые операции, включая сквозной деплой
- Диагностика — Анализ упавших выполнений, проверка логов, выявление проблем
Агенты
| Агент | Описание |
|---|---|
component-builder | Собирает кастомные компоненты от требований до деплоя. Использует DAG-опросник, опциональное исследование API и пофазовые скрипты для скаффолдинга, сборки и публикации. |
cni-builder | Собирает Code Native Integrations от требований до деплоя. Управляет манифестами компонентов, конфигурацией OAuth, генерацией TypeScript, деплоем и тестовыми циклами. |
external-api-researcher | Исследует внешние API: загружает и анализирует документацию, извлекает методы аутентификации, эндпоинты, модели данных и возможности вебхуков в структурированный JSON-спек. Запускается только когда DAG требований определяет необходимость исследования. |
orby | Интерактивный гид по платформе Prismatic. Исследует окружение, выполняет операции на платформе, строит GraphQL-запросы, ищет по документации и оркестрирует многошаговые воркфлоу. |
Скиллы
Плагин включает четыре базы знаний, которые используют агенты:
| Скилл | Назначение |
|---|---|
component-patterns | Справочная документация, паттерны генерации кода и полные примеры (утилита, коннектор с API-ключом, OAuth2-коннектор) для создания кастомных компонентов |
integration-patterns | Справочная документация, библиотека CNI-паттернов (вебхуки, персистентность состояния, обработка ошибок, OAuth, multi-flow и др.) и руководство по генерации кода для Code Native Integrations |
prismatic-api | Справочник GraphQL-запросов, иерархия доступа к API (MCP-инструменты / Prism CLI), паттерны запросов для клиентов, инстансов, выполнений, логов, компонентов и интеграций |
prismatic-docs | Стратегии поиска по документации prismatic.io/docs и навигация по примерам кода из репозитория примеров Prismatic |
Скрипты
Агенты-строители управляются TypeScript-скриптами в scripts/, которые обрабатывают каждую фазу воркфлоу. Агенты вызывают эти скрипты через npx tsx, а не выполняют операции на платформе напрямую.
Скрипты воркфлоу (корневой уровень):
prerequisites.ts— Проверка Prism CLI, аутентификации и создание директории сессииgather-requirements.ts— Интерактивный DAG-опросник, который проходит требования в порядке зависимостей, автоматически пропуская нерелевантные вопросыwrite-answer.ts— Запись ответа в файл требований для программного использования
Скрипты компонентов (scripts/components/):
scaffold-component.ts— Создание структуры проекта компонента через Prism CLIbuild-component.ts— Компиляция TypeScript с помощью webpackpublish-component.ts— Деплой компонента в Prismaticvalidate-component.ts— Валидация опубликованного компонента
Скрипты интеграций (scripts/integrations/):
scaffold-project.ts— Создание CNI-проекта с манифестами компонентовfind-components.ts— Поиск доступных компонентов Prismaticextract-connections.ts— Извлечение параметров подключения из компонентовget-credential-prompts.ts— Получение полей учётных данных для подключенияbuild-integration.ts— Компиляция интеграцииdeploy-integration.ts— Деплой интеграции в Prismatictest-integration.ts— Запуск тестов интеграции