AIKraft/Skills/next-cache-components-adoption

next-cache-components-adoption

Включает Cache Components в Next.js, разрешает блокирующие маршруты и ошибки валидации. Применяется при миграции, запуске codemod cache-components-instant-false или настройке опции instant false.

VEVercel official Разработка ★ 143.2k

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

Настройка опции cacheComponents: true в конфигурации Next.js для включения Cache Components в App Router. Skill последовательно применяет изменения, разрешает блокирующие маршруты и ошибки валидации, доводя проект до успешной сборки.

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

  • Миграция проекта на Cache Components с использованием codemod cache-components-instant-false.
  • Настройка опции instant false для управления поведением кэширования.
  • Исправление ошибок сборки, связанных с устаревшими ключами конфигурации (dynamic, revalidate, fetchCache).
  • Устранение фатальных ошибок из-за использования удаленного ключа experimental.dynamicIO.

Как работает

  1. Проверить версию Next.js (должна быть 16.3+) и выполнить upgrade codemods при необходимости.
  2. Убедиться, что проект использует App Router (наличие директории app/ или src/app/), а не Pages Router.
  3. Заменить устаревший ключ experimental.dynamicIO на top-level cacheComponents: true и удалить experimental.useCache.
  4. Инвентаризировать и удалить экспорты dynamic, revalidate или fetchCache, заменив их согласно руководству по миграции.
  5. Запустить приложение через next dev и проверить работу в браузере, исправляя ошибки валидации из dev overlay.
  6. Провести финальную сборку для подтверждения успешного применения настроек.

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

Включи Cache Components в моем проекте Next.js и исправь ошибки сборки.
Примени codemod cache-components-instant-false и настрой опцию instant false.
Исправь конфигурацию Next.js: замени experimental.dynamicIO на cacheComponents и удали конфликтующие ключи.

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

  • Next.js версии 16.3 или новее.
  • Проект с использованием App Router (директория app/ или src/app/).
  • Рабочее окружение, позволяющее запустить приложение через next dev.

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

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

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

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