next-cache-components-optimizer
Оптимизирует кэширование компонентов Next.js (PPR) для мгновенной навигации. Применяется при настройке Cache Components, ускорении первичной отрисовки, диагностике проблем с Suspense или написании e2e-тестов instant() для Next.js 16.3+.
Что делает навык
Настраивает цикл оптимизации кэширования компонентов Next.js (PPR), превращая маршруты из «не мгновенных» в «мгновенные» за счет максимизации статической оболочки. Применяется для ускорения первичной отрисовки и навигации с использованием флага cacheComponents. Результат гарантируется автотестом, который проверяет, что статический контент отображается сразу, а динамические данные подгружаются потоком.
Когда применять
- Настройка Cache Components и оптимизация маршрутов Next.js 16.3+ для мгновенной навигации.
- Диагностика проблем с Suspense и исправление задержек при первичной отрисовке страниц.
- Написание e2e-тестов с использованием функции instant() из @next/playwright для верификации производительности.
- Оптимизация параллельных маршрутов, шлюзов аутентификации и устранение режимов пустой оболочки.
Как работает
- Проверка требований: убедиться, что используется Next.js 16.3+ с включенным cacheComponents: true и установлен @next/playwright.
- Настройка окружения (Rig): создать production-сборку с открытым API тестирования (exposeTestingApiInProductionBuild) и записать параметры в instant-nav.rig.md.
- Создание базового теста (Baseline): запустить навигацию без блокировки, чтобы убедиться, что целевой маркер оболочки (SHELL_MARKER) рендерится для тестового пользователя.
- Создание красного теста (RED): обернуть навигацию в instant() и подтвердить, что оболочка не фиксируется под блокировкой, записывая разрыв.
- Верификация RED (C-gate): убедиться, что красный результат вызван реальной блокировкой, а не ошибками окружения или маркера.
- Исправление (Fix): опустить границы Suspense вниз к данным, которые они защищают, используя существующие UI загрузки (loading.tsx) вместо ручной верстки.
Примеры запросов агенту
Что понадобится
- Next.js 16.3+ с включенным флагом cacheComponents: true в next.config.ts
- Пакет @next/playwright, установленный на той же версии, что и next
- Возможность сборки production-версии с включенным experimental.exposeTestingApiInProductionBuild
Описание составлено по SKILL.md навыка, сверено 06.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.