AIKraft/Skills/next-dev-loop

next-dev-loop

Проверяет поведение Next.js после изменений в коде, подтверждая, что они работают в запущенном приложении, а не только компилируются. Использует /_next/mcp и agent-browser. Требует запущенный next dev.

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

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

Навык обеспечивает цикл редактирования и проверки в Next.js, подтверждая работоспособность изменений в запущенном приложении, а не только успешность компиляции. Он использует два источника данных: HTTP-эндпоинт /_next/mcp для проверки состояния сервера и фреймворка, и CLI agent-browser для проверки DOM и поведения в реальном браузере. Это позволяет кросс-проверять результаты и выявлять ошибки, которые не видны при статическом анализе.

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

  • Проверка того, что внесённые изменения в код корректно отобразились на странице и не вызвали ошибок рендеринга.
  • Диагностика проблем с серверными действиями (server actions), маршрутизацией или компонентами RSC через метаданные Next.js.
  • Анализ поведения React на уровне дерева компонентов, пропсов и состояний с использованием React DevTools.
  • Отладка сценариев, требующих сохранения состояния входа (login state) между сессиями браузера.

Как работает

  1. Выполнить preflight: запустить agent-browser для открытия целевого URL с сохранением сессии и проверить доступность эндпоинта /_next/mcp (tools/list, get_compilation_issues).
  2. Перед редактированием кода использовать /_next/mcp (get_routes, get_page_metadata) для определения файлов, отвечающих за текущий маршрут, чтобы сузить область поиска.
  3. Внести изменения в код и запустить проверку компиляции через get_compilation_issues.
  4. Проверить отсутствие ошибок выполнения, используя данные из /_next/mcp (get_errors, get_logs).
  5. Запустить agent-browser для навигации по странице, ожидания загрузки (wait --load networkidle) и проверки визуального поведения и DOM.
  6. При необходимости включить react-devtools в agent-browser для проверки дерева компонентов, пропсов и количества рендеров на уровне React.

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

Я изменил компонент заголовка, проверь, что он правильно отобразился и нет ошибок в консоли.
После добавления нового маршрута убедись, что он доступен и данные загружаются корректно.
Проверь, не вызывает ли моё изменение лишних рендеров в React-компонентах.

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

  • Next.js 16.3+ с Turbopack (для эндпоинта /_next/mcp и get_compilation_issues).
  • agent-browser >= 0.31.1 (CLI для управления браузером Chrome).
  • Запущенный сервер next dev.

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

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

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

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