SuperAPI AI 工具集

architect-nextjs

前端与建站

查看项目

更新于 10-15 22:39

技能介绍

用途:为 Next.js 15+ 应用建立可扩展的架构基础,用规则约束代码放在哪里、以何种形式存在。适用于(1)新建项目,(2)检查或整理既有项目结构。

主要能力与原则: 作用域规则(绝对法则)——“作用域决定结构”。仅被单个功能使用的代码必须留在本地,例如 (user)/profile/_components;被两个及以上功能使用的代码必须移到 src/shared/。不为单次使用的组件污染 shared。 尖叫架构:目录结构应立刻表明应用做什么。用路由组 (feature) 表示顶层模块,避免在顶层使用 containers、views 这类泛化目录。 Next.js 15 标准:只用 App Router,不使用 pages/ 目录;默认服务端优先,组件默认是 Server Component;数据访问在 Server Component 中直接获取,或通过 Server Actions。

决策框架:先数使用次数——被 1 个功能使用放入 app/(feature)/_components/,被 2 个及以上使用放入 src/shared/components/。再判断类型——Server Component 为默认,用于静态内容和初始数据获取;Client Component 仅在需要 useState、useEffect 或事件监听时使用;Server Action 用于变更与表单处理,放在 _actions/name.ts。

实现指南:提供项目结构模板,用于新建文件夹或核对某文件应放在何处;提供组件模板,涵盖带 Suspense 与数据获取的 Server Components、为交互隔离的 Client Components、类型与校验完整的 Server Actions。

质量检查清单:该代码是否用于超过一个功能?否则移到 _components。“use client” 是否绝对必要?能否下推到组件树更低层?文件夹名是否描述其功能(如 (invoices) 而非 pages)?专属 hooks、类型、样式是否与使用者就近放置?

限制:资料未提供具体安装命令、依赖版本、代码示例细节、收费或平台信息,暂未提供。