AIKraft/Skills/next-cache-components-optimizer

next-cache-components-optimizer

Оптимизирует кэширование компонентов Next.js (PPR) для мгновенной навигации. Применяется при настройке Cache Components, ускорении первичной отрисовки, диагностике проблем с Suspense или написании e2e-тестов instant() для Next.js 16.3+.

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

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

Настраивает цикл оптимизации кэширования компонентов Next.js (PPR), превращая маршруты из «не мгновенных» в «мгновенные» за счет максимизации статической оболочки. Применяется для ускорения первичной отрисовки и навигации с использованием флага cacheComponents. Результат гарантируется автотестом, который проверяет, что статический контент отображается сразу, а динамические данные подгружаются потоком.

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

  • Настройка Cache Components и оптимизация маршрутов Next.js 16.3+ для мгновенной навигации.
  • Диагностика проблем с Suspense и исправление задержек при первичной отрисовке страниц.
  • Написание e2e-тестов с использованием функции instant() из @next/playwright для верификации производительности.
  • Оптимизация параллельных маршрутов, шлюзов аутентификации и устранение режимов пустой оболочки.

Как работает

  1. Проверка требований: убедиться, что используется Next.js 16.3+ с включенным cacheComponents: true и установлен @next/playwright.
  2. Настройка окружения (Rig): создать production-сборку с открытым API тестирования (exposeTestingApiInProductionBuild) и записать параметры в instant-nav.rig.md.
  3. Создание базового теста (Baseline): запустить навигацию без блокировки, чтобы убедиться, что целевой маркер оболочки (SHELL_MARKER) рендерится для тестового пользователя.
  4. Создание красного теста (RED): обернуть навигацию в instant() и подтвердить, что оболочка не фиксируется под блокировкой, записывая разрыв.
  5. Верификация RED (C-gate): убедиться, что красный результат вызван реальной блокировкой, а не ошибками окружения или маркера.
  6. Исправление (Fix): опустить границы Suspense вниз к данным, которые они защищают, используя существующие UI загрузки (loading.tsx) вместо ручной верстки.

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

Оптимизируй кэширование компонентов на маршруте /dashboard для Next.js 16.3+, чтобы навигация стала мгновенной.
Настрой цикл оптимизации Cache Components для главной страницы, используя @next/playwright instant() для верификации.
Исправь задержку отрисовки профиля пользователя, опустив границы Suspense и максимизировав статическую оболочку.

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

  • Next.js 16.3+ с включенным флагом cacheComponents: true в next.config.ts
  • Пакет @next/playwright, установленный на той же версии, что и next
  • Возможность сборки production-версии с включенным experimental.exposeTestingApiInProductionBuild

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

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

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

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