SuperAPI AI 工具集

architect-nextjs

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:为 Next.js 15+ 应用建立可扩展的架构基础,通过强制 Scope Rule 与 Screaming Architecture 决定代码应该放在哪里。适用于新项目搭建、目录结构调整以及判断某个文件应归属何处。

核心原则:一是 Scope Rule,代码被 1 个功能使用必须保持局部(如 (user)/profile/_components);被 2 个及以上功能使用才放入 src/shared/,不得把单次使用的组件放入共享目录。二是 Screaming Architecture,目录结构应直接说明应用做什么,顶层使用 Route Groups 表达功能模块,避免 containers、views 这类泛化文件夹。

Next.js 15 标准:仅使用 App Router,不使用 pages/ 目录;默认使用 Server Components;数据可直接在 Server Components 中获取,或通过 Server Actions 处理。

决策框架:先统计使用范围,被 1 个功能使用放 app/(feature)/_components/,被 2 个以上使用放 src/shared/components/;再判断类型,Server Component 为默认,仅当需要 useState、useEffect 或事件监听时才用 Client Component,变更与表单处理使用 Server Action,放在 _actions/name.ts。

实施参考:提供项目结构模板与组件模板,涵盖带 Suspense 与数据获取的 Server Component、隔离交互的 Client Component、类型与校验完备的 Server Action。

检查清单:确认组件是否被多于 1 个功能使用;确认 use client 是否绝对必要、能否下推;确认文件夹名是否描述其用途;确认专用 hooks、类型与样式是否与使用它们的组件放在一起。

限制:资料未提供该技能的安装命令、运行环境要求、授权与收费方式,这些信息暂未提供。