SuperAPI AI 工具集

nextjs-stack

编程与开发

查看项目

更新于 10-28 08:31

技能介绍

nextjs-stack 是面向现代 Next.js 开发的完整技术栈主参考技能,用于指导从零搭建 Next.js 16 及以上项目、构建带认证的生产应用,以及理解栈内各层如何配合。

用途与定位 该技能整合了框架与周边技术的文档,适合需要完整推荐技术栈、实现表单与状态管理及 UI 组件、或论证技术选型的场景。资料明确说明它不负责路由内部、缓存、proxy.ts 等核心框架 API 细节,这些内容由 nextjs-16 等子技能覆盖。

技术栈范围

  • 框架:Next.js 16(App Router,稳定版 16.3)
  • 数据库 ORM:Prisma 7(稳定版 7.10;8.0 仅为 RC)
  • 认证:Better Auth 1.7
  • UI 组件:shadcn/ui CLI 4.21.0
  • 表单:TanStack Form
  • 状态:Zustand
  • 样式:Tailwind CSS 4
  • 国际化:next-intl 4.14

禁止的替代方案 资料列出了不应采用的模式:用 NextAuth.js 代替 Better Auth;用 Pages Router 代替 App Router;用 React Hook Form 代替 TanStack Form;默认使用客户端组件而非服务端优先。

使用方式与协作流程 资料要求在任何实现前并行启动三个代理:explore-codebase 分析项目结构与既有模式,research-expert 核实所有栈技术的最新文档,mcp__context7__query-docs 检查集成兼容性。实现完成后运行 sniper 进行验证。

参考材料 详细指导分散在 references/ 目录,按需加载:stack-decisions.md 用于论证技术选型(如 Better Auth 对比 NextAuth、Prisma 对比 Drizzle、TanStack Form 对比 RHF、Zustand 对比 Redux、shadcn/ui 对比 MUI);solid-architecture.md 用于搭建或审查模块与目录结构;integration-points.md 用于连接栈内两部分(认证与数据库、表单与 UI、状态与 RSC、i18n 与路由);quick-reference.md 用于查找具体功能对应的子技能文件;best-practices.md 用于发布前最终审查;getting-started.md 用于逐步引导新项目。

适用场景与限制 适合新项目引导、技术栈决策论证、模块结构设计和集成点梳理。具体框架 API 细节需转向对应子技能;资料未提供价格、收费或平台支持信息,相关事实暂未提供。