VE
next-cache-components-adoption
Включает Cache Components в Next.js, разрешает блокирующие маршруты и ошибки валидации. Применяется при миграции, запуске codemod cache-components-instant-false или настройке опции instant false.
Что делает навык
Настройка опции cacheComponents: true в конфигурации Next.js для включения Cache Components в App Router. Skill последовательно применяет изменения, разрешает блокирующие маршруты и ошибки валидации, доводя проект до успешной сборки.
Когда применять
- Миграция проекта на Cache Components с использованием codemod cache-components-instant-false.
- Настройка опции instant false для управления поведением кэширования.
- Исправление ошибок сборки, связанных с устаревшими ключами конфигурации (dynamic, revalidate, fetchCache).
- Устранение фатальных ошибок из-за использования удаленного ключа experimental.dynamicIO.
Как работает
- Проверить версию Next.js (должна быть 16.3+) и выполнить upgrade codemods при необходимости.
- Убедиться, что проект использует App Router (наличие директории app/ или src/app/), а не Pages Router.
- Заменить устаревший ключ experimental.dynamicIO на top-level cacheComponents: true и удалить experimental.useCache.
- Инвентаризировать и удалить экспорты dynamic, revalidate или fetchCache, заменив их согласно руководству по миграции.
- Запустить приложение через next dev и проверить работу в браузере, исправляя ошибки валидации из dev overlay.
- Провести финальную сборку для подтверждения успешного применения настроек.
Примеры запросов агенту
Включи 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 и совместимые) подхватывает его по описанию и следует шагам.