MA
cmux-billing
Руководство по работе с биллингом cmux: Stripe Checkout, подписки, Pro-план, вебхуки и права доступа. Применяется при редактировании, отладке биллинга, цен, записи подписок и настройке инструментов для dev/prod.
Что делает навык
Навигация по архитектуре биллинга cmux: маршруты Stripe Checkout, Portal, подписок и вебхуков, а также логика определения статуса Pro через metadata и административные оверрайды. Решает задачи отладки, редактирования цен, настройки инструментов для dev/prod и управления правами доступа к Pro-плану.
Когда применять
- Отладка и изменение кода, связанного с биллингом, ценами и Stripe.
- Настройка записи подписок и проверка логики idempotent-рекордера purchase.ts.
- Управление правами доступа: гранты администраторов, оверрайды cmuxVmPlan и проверка статуса Pro.
- Работа с вебхуками Stripe и проверка безопасности обработки событий.
Как работает
- Изучить архитектуру: маршруты /api/billing/checkout, /portal, /subscription и /dashboard/billing.
- Проверить логику определения плана: приоритет cmuxVmPlan над cmuxPlan и статус resolveProPlanStatus.
- Анализировать вебхуки /api/stripe/webhook: сигнатуры, idempotency через stripe_webhook_events и фильтрацию по metadata.app.
- Использовать административные маршруты /api/admin/* для грантов, отмены подписок и аудита.
- Следовать правилам безопасности: requireAdmin, проверка доменов и отсутствие UI админки в репозитории.
Примеры запросов агенту
Как работает определение статуса Pro для пользователя с cmuxVmPlan оверрайдом?
Проверь логику idempotency в /api/stripe/webhook и purchase.ts.
Какие права нужны для вызова /api/admin/subscriptions и как работает requireAdmin?
Что понадобится
- Настроенный STRIPE_SECRET_KEY для работы Stripe Checkout.
- Доступ к базе данных для таблиц stripe_customers, stripe_subscriptions, admin_plan_grants.
- Проверенный email (cmux.com, manaflow.ai, manaflow.com) или active admin_members row для админ-доступа.
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «cmux-billing» из репозитория:
# https://github.com/manaflow-ai/cmux
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r cmux-billing/ ~/.claude/skills/cmux-billing/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.