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 细节需转向对应子技能;资料未提供价格、收费或平台支持信息,相关事实暂未提供。