convex-migration-helper
Планирование безопасных миграций данных Convex
Ломающие изменения схемы Convex могут приводить к сбоям deploy или повреждать production-данные. Этот skill помогает с безопасными rollout, batched backfills, dry runs и проверкой.
Установить с помощью моего Агента
Скопируйте этот запрос в своего Агента. Он содержит каноническую страницу Skill и манифест.
Review the Skillstore skill "convex-migration-helper" from https://skillstore.io/skills/get-convex-convex-migration-helper.md and its manifest at https://skillstore.io/api/skills/get-convex-convex-migration-helper/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Ваш Агент по-прежнему должен показать план и запросить все подтверждения, требуемые политикой безопасности.
Ресурсы для AI-агентов
Используйте эти ссылки, когда AI-агенту, crawler или script нужен чистый контекст вместо полной страницы.
Протестировать
Использование «convex-migration-helper». Таблице пользователей нужно новое обязательное поле role для существующих аккаунтов.
Ожидаемый результат:
- Разверните расширенную схему, где role является необязательным.
- Заполните отсутствующие role пакетами, сначала выполнив dry run.
- Перед тем как сделать role обязательным, убедитесь, что не осталось немигрированных аккаунтов.
Использование «convex-migration-helper». Таблица команд меняется с логического флага plan на enum plan.
Ожидаемый результат:
- Добавьте новое поле plan, сохранив старый флаг необязательным.
- Во время перехода записывайте новые документы в новом формате.
- Удаляйте старые readers и поля только после успешной проверки.
Использование «convex-migration-helper». Миграция большой таблицы постоянно превышает время ожидания во время локальных тестов.
Ожидаемый результат:
- Используйте компонент migrations вместо сбора всей таблицы.
- Уменьшите размер batch для тяжелых документов или высокого write-трафика.
- Отслеживайте статус миграции и повторяйте запуск с сохраненного cursor после сбоев.
Аудит безопасности
БезопасноAll static findings were adjudicated as false positives. The apparent SQLite and shell execution findings are Convex ctx.db examples and Markdown backticks in documentation. No prompt injection, data exfiltration intent, or hidden malicious behavior was found in the reviewed skill files.
Факторы риска
⚙️ Внешние команды (14)
🌐 Доступ к сети (1)
Поделиться и цитировать этот отчет
Делитесь версионным отчетом об оценке, нейтральным значком, встраиваемой карточкой и цитатами. Skillstore публикует доказательства, не решая, безопасен ли этот Skill.
Копировать ссылку на отчёт
https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportЗначок Markdown
[](https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge)Значок HTML
<a href="https://skillstore.io/skills/get-convex-convex-migration-helper?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/get-convex-convex-migration-helper/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Встраиваемая карточка
<iframe src="https://skillstore.io/embed/skills/get-convex-convex-migration-helper.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Академические ссылки (APA · BibTeX · CFF)
Цитата APA
get-convex. (2026). convex-migration-helper security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4Цитата BibTeX
@techreport{get-convex-get-convex-convex-migration-helper-2026,
author = {get-convex},
title = {convex-migration-helper security audit report (audit version 4)},
institution = {Skillstore},
year = {2026},
number = {4},
url = {https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "convex-migration-helper security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
- name: "get-convex"
date-released: "2026-07-05"
url: "https://skillstore.io/skills/get-convex-convex-migration-helper/audits/4"
identifiers:
- type: other
value: "skillstore:get-convex-convex-migration-helper:audit:4"
description: "Skillstore immutable audit report identifier"
Оценка Skillstore
Почему такая оценка Достоверность доказательств: ВысокийЧто вы можете построить
Безопасное добавление обязательных полей
Спланировать rollout, который сначала добавляет необязательные поля, затем заполняет существующие документы и только после проверки делает поля обязательными.
Подготовка rollout без простоя
Спроектировать поэтапные deploys, в которых код приложения обрабатывает старые и новые форматы данных во время окон миграции.
Рефакторинг существующих моделей данных
Составить шаги для удаления полей, изменения типов, разделения таблиц, очистки orphan-записей и проверок завершения миграции.
Попробуйте эти промпты
Проверь это изменение схемы Convex и скажи, нужна ли для него миграция данных. Объясни порядок развертывания и основные риски.
Создай план widen-migrate-narrow для добавления обязательного поля в существующую таблицу Convex. Включи заметки по проверке и rollback.
Помоги мне спроектировать пакетную миграцию Convex с dry run, мониторингом статуса и безопасным размером batch для этой таблицы.
Проведи аудит этого плана миграции Convex на безопасность для production. Проверь расширение схемы, dual reads или writes, покрытие dry run и проверки завершения.
Лучшие практики
- Расширьте схему перед изменением production-данных.
- Выполните dry run и проверьте статус перед запуском в production.
- Убедитесь, что каждый документ мигрирован, прежде чем сужать схему.
Избегать
- Делать поле обязательным до того, как существующие документы будут заполнены.
- Использовать collect для больших таблиц вместо пакетной миграции.
- Удалять legacy-поля до того, как readers и writers перестанут их использовать.
Часто задаваемые вопросы
Что такое widen-migrate-narrow?
Этот skill запускает миграции автоматически?
Когда следует использовать @convex-dev/migrations?
Может ли он помочь с нулевым простоем?
Поддерживает ли он миграции небольших таблиц?
Что нужно сделать перед production?
Сведения для разработчиков
Автор
get-convexЛицензия
MIT
Ревизия Skillstore
r1
Примечание о версии
Автор не указал версию.
Ссылка
30c73eac2afe762f6aa9c4553158769369d47351
Актуальность поддержки
18.07.2026
Использование
3 загрузок · 88 просмотров
Структура файлов