SuperAPI AI 工具集

nextjs

前端与建站

查看项目

更新于 10-16 11:55

技能介绍

Next.js App Router 技能面向使用 Next.js App Router 构建现代 Web 应用的开发者,提供专家级知识。

用途:帮助开发者与 AI 编码代理理解并运用 Next.js App Router 的相关模式,包括 Server Components、Client Components、Server Actions、Route Handlers 等。

主要能力:

  • 覆盖 Next.js 16.1+ 的 App Router 模式与核心概念。
  • 介绍 Next.js 16.1.1 的亮点:Turbopack 改进(更快的 next dev 重启,视项目而定)、实验性 Bundle Analyzer(next experimental-analyze)、更方便的调试(next dev --inspect)、升级命令(next upgrade)、内置 /_next/mcp 端点供编码智能体使用。
  • MCP 服务器(面向编码智能体):Next.js 16+ 通过 next-devtools-mcp 提供 MCP 支持。配置示例位于项目根目录的 .mcp.json 中: { "mcpServers": { "next-devtools": { "command": "npx", "args": ["-y", "next-devtools-mcp@latest"] } } }
  • 可用工具包括:get_errors(构建错误、运行时错误和类型错误)、get_logs(开发日志文件路径,含浏览器控制台和服务端输出)、get_page_metadata(路由、组件、渲染信息)、get_project_metadata(项目结构、配置、开发服务器 URL)、get_server_action_by_id(按 ID 查找 Server Actions)。
  • 能力包括:错误检测(实时构建/运行时/类型错误)、实时状态查询(访问应用状态与运行时信息)、页面元数据(查询路由、组件、渲染细节)、Server Actions(检查 Server Actions 与组件层级)、知识库(查询 Next.js 文档)、迁移工具(使用 codemods 的自动化升级辅助)、Playwright 集成(通过 Playwright MCP 进行浏览器测试)。

核心概念:

  • Server Components(默认):app/ 目录下的所有组件默认都是 Server Components,可执行异步数据获取。
  • Client Components:使用 'use client' 指令实现交互性,例如结合 useState。
  • Server Actions:使用 'use server' 处理变更操作,并可配合 revalidatePath 重新验证路径。

文件约定:page.tsx(路由的唯一 UI)、layout.tsx(共享 UI 包装器)、loading.tsx(加载 UI,Suspense)、error.tsx(错误边界)、not-found.tsx(404 UI)、route.ts(API 端点)。

参考资料:references/routing.md(路由模式)、references/data-fetching.md(数据获取策略)、references/server-actions.md(Server Actions 指南)。

资源模板:assets/page.tsx(基础页面模板)、assets/layout.tsx(布局模板)、assets/route-handler.ts(API 路由模板)、assets/server-action.ts(Server Action 模板)、assets/middleware.ts(中间件模板)。

限制:资料未提供关于收费、价格、平台支持范围或具体效果保证的信息,相关内容暂未提供。