AIKraft/Skills/v5-breaking-changes

v5-breaking-changes

Внедряет или проверяет изменения с переломной совместимостью в Remotion 5, пока ветки v4 и v5 разделяют код. Применяется, когда нужно сохранить совместимость v4 на main, но активировать новое поведение или API через флаг v5.

RERemotion official Разработка ★ 73.2k

Что делает навык

Навык обеспечивает управление флагом переломных изменений (breaking changes) для Remotion 5, позволяя разделять поведение версий v4 и v5 в единой кодовой базе. Он гарантирует, что изменение одной константы активирует новое поведение и TypeScript API одновременно, сохраняя совместимость v4 на ветке main.

Когда применять

  • Необходимо внедрить новую функциональность Remotion 5, не нарушая работу существующего кода на v4.
  • Требуется активировать новое поведение через флаг v5, пока ветки v4 и v5 разделяют код.
  • Необходимо подготовить релизную линию v5, изменив флаг на true для активации всех изменений.
  • Внедрение изменений, требующих строгой типизации через literal type флага.

Как работает

  1. Использовать центральный флаг времени компиляции из packages/core/src/v5-flag.ts.
  2. Убедиться, что флаг имеет тип literal false as const на ветке v4/main и не является переменной окружения или опцией времени выполнения.
  3. Импортировать флаг из v5-flag.ts внутри packages/core.
  4. Использовать NoReactInternals.ENABLE_V5_BREAKING_CHANGES из remotion/no-react в других пакетах для обеспечения единого значения.
  5. Заблокировать (gate) поведение времени выполнения и публичный API TypeScript с помощью этого флага.
  6. При отсечении линии релиза v5 изменить значение константы на true as const для активации нового поведения.

Примеры запросов агенту

Как правильно импортировать флаг v5 в другом пакете, чтобы использовать единое значение?
Проверь, что флаг ENABLE_V5_BREAKING_CHANGES остается literal false as const на ветке main.
Как активировать поведение Remotion 5 и новый TypeScript API одновременно при подготовке релиза?

Что понадобится

  • Доступ к файлу packages/core/src/v5-flag.ts
  • Доступ к модулю remotion/no-react для использования NoReactInternals

Описание составлено по SKILL.md навыка, сверено 16.11.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «v5-breaking-changes» из репозитория: # https://github.com/remotion-dev/remotion
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r v5-breaking-changes/ ~/.claude/skills/v5-breaking-changes/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.