Stripe Projects

Предоставление SaaS-сервисов и синхронизация учётных данных через Stripe Projects.

Метаданные навыка

Источник	Опционально — установка с помощью vibeos skills install official/payments/stripe-projects
Путь	optional-skills/payments/stripe-projects
Версия	0.1.0
Автор	Teknium (teknium1), VibeOS
Лицензия	MIT
Платформы	linux, macos
Теги	Payments, Stripe, Projects, Provisioning, Infrastructure
Связанные навыки	stripe-link-cli, mpp-agent

Справочник: полный SKILL.md

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

Навык Stripe Projects

Обёртка для CLI-плагина Stripe Projects, позволяющая VibeOS предоставлять SaaS-сервисы (Neon, Twilio, Vercel и др.), генерировать и синхронизировать учётные данные в .env пользователя, а также управлять биллингом у разных провайдеров из одного места.

Ограничен [linux, macos], пока более широкий кластер платежей не станет стабильным на Windows. Сам Stripe CLI кроссплатформенный; это ограничение — позиционирование кластера, а не жёсткое требование.

Когда использовать

Фразы-триггеры:

• «настрой <провайдер>», «предоставь <Neon|Twilio|Vercel|...>», «создай базу данных»
• «дай мне <Postgres|Redis|номер Twilio|...> для этого проекта»
• «управляй моими учётными данными стека», «ротируй этот ключ», «обнови мой тариф»
• «каких провайдеров я могу добавить?»

Если у пользователя уже есть аккаунт провайдера, этот навык всё равно может подключить его с помощью stripe projects link <provider>. Если пользователь хочет использовать существующий ресурс провайдера, например, существующую базу данных или проект Vercel, сначала проверьте поддержку провайдера; многие провайдеры в настоящее время поддерживают предоставление новых ресурсов, но не импорт существующих.

Предварительные требования

• Установленный Stripe CLI (Homebrew на macOS, менеджер пакетов на Linux или загрузка с https://docs.stripe.com/stripe-cli/install)
• Установленный плагин Stripe Projects
• Аккаунт Stripe. Если у пользователя его ещё нет, CLI может провести его через процесс входа или создания аккаунта в браузере во время настройки.

Установка

macOS:

brew install stripe/stripe-cli/stripe
stripe plugin install projects

Linux: следуйте инструкции по установке для вашей платформы на https://docs.stripe.com/stripe-cli/install, затем:

stripe plugin install projects

Как запускать

Все команды выполняются через инструмент terminal из каталога проекта пользователя (CLI записывает .env и .projects/vault/vault.json в текущую рабочую директорию).

Процедура

1. Инициализация проекта

cd <корень-проекта>
stripe projects init

Это создаёт .projects/vault/vault.json (зашифрованное хранилище учётных данных) и подготавливает проект к подключению провайдеров.

2. Просмотр доступных провайдеров

stripe projects catalog

Выводит список всех провайдеров, поддерживаемых Stripe Projects — базы данных, хостинг, аутентификация, ИИ, аналитика, обмен сообщениями и т.д.

3. Добавление сервиса

stripe projects add <провайдер>/<сервис>

Примеры:

• stripe projects add neon/postgres
• stripe projects add twilio/sms
• stripe projects add runloop/sandbox

CLI предоставляет сервис в собственном аккаунте пользователя у провайдера, генерирует учётные данные, синхронизирует их в .env и записывает ресурс в хранилище. Возможно, пользователю потребуется подтвердить выбор тарифа или ценовое предложение.

4. Проверка

stripe projects list

Должен показать только что добавленного провайдера и его ключи в .env.

5. Управление / обновление / удаление

stripe projects upgrade <провайдер>     # изменение тарифа
stripe projects remove <провайдер>      # депровизионирование
stripe projects rotate <провайдер>      # ротация учётных данных

Подводные камни

• Запись в .env — это реальная запись. CLI добавляет данные в любой .env, находящийся в корне проекта. Если .env пользователя добавлен в .gitignore (обычная практика), ключи в безопасности; если нет, этот навык может стать вектором утечки учётных данных. Всегда сначала проверяйте .gitignore.
• Состояние привязано к проекту. Файл .projects/vault/vault.json уникален для каждого проекта. Предоставление одного и того же сервиса в двух разных проектах создаёт два отдельных ресурса — и два счёта.
• Биллинг происходит на стороне Stripe. Предложения по тарифам во время add/upgrade — это реальные списания; сообщайте о них пользователю перед подтверждением.
• Доступность провайдеров меняется. Каталог растёт; если провайдер, которого назвал пользователь, отсутствует в списке, сначала выполните stripe projects catalog | grep <имя>, а не вызывайте ошибку при add.
• Учётные данные в хранилище зашифрованы, но .env — это открытый текст. Применяются стандартные правила гигиены для .env — никогда не коммитьте его.
• Удаление сервиса НЕ всегда уничтожает базовый ресурс. Некоторые провайдеры оставляют приостановленный или неактивный ресурс. Проверяйте панель управления самого провайдера после remove для дорогостоящих сервисов (особенно управляемых баз данных).

Проверка

stripe projects --version && stripe projects list

Код возврата 0 внутри инициализированного проекта означает, что плагин работает исправно.