用途:该技能用于为 Next.js 15+ 应用建立架构基础,通过强制 Scope Rule 与 Screaming Architecture 来组织可扩展的项目结构,适合新项目搭建或核对文件应放置的位置。
主要能力:包含三大原则。其一为 Scope Rule(绝对法则)——作用域决定结构:被单个功能使用的代码必须保持本地,例如位于 (user)/profile/_components;被两个及以上功能使用的代码必须放入 src/shared/,且不得把一次性组件混入 shared。其二为 Screaming Architecture——目录结构应直接表达应用做什么,顶层模块使用路由组如 (feature),避免在顶层使用 containers、views 这类泛化文件夹。其三为 Next.js 15 标准——仅用 App Router,不使用 pages/ 目录;默认采用 Server Components;数据可直接在 Server Components 中获取,或通过 Server Actions 处理。
使用方式:放置文件时按决策树判断。先数使用次数:仅一个功能使用则放 app/(feature)/_components/,两个及以上功能使用则放 src/shared/components/。再判断类型:Server Component 为默认,用于静态内容和初始数据获取;Client Component 仅在需要 useState、useEffect 或事件监听时使用;Server Action 用于变更和表单处理,放在 _actions/name.ts。技能提供项目结构模板与组件模板参考,后者涵盖带 Suspense 与数据获取的 Server Components、隔离交互的 Client Components,以及带类型与校验的 Server Actions。
适用场景:搭建新 Next.js 15+ 项目、创建或校验目录与文件归属、审查组件是否为客户端组件。
限制:资料未提供安装命令、依赖或具体代码示例,也未说明收费与平台信息;使用前需自行确认与现有项目的兼容性。