Stripe Projects

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

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

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

Навык Stripe Projects

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

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

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

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

• «настрой <provider>», «разверни <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 <project-root>
stripe projects init

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

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

stripe projects catalog

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

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

stripe projects add <provider>/<service>

Примеры:

• 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 <provider>     # tier change
stripe projects remove <provider>      # deprovision
stripe projects rotate <provider>      # rotate credentials

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

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

Проверка

stripe projects --version && stripe projects list

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