SuperAPI AI 工具集

nuxt-best-practices

前端与建站

查看项目

更新于 10-16 07:17

技能介绍

用途:该技能为 Nuxt 3/4 全栈应用的性能优化与架构规范指南,适用于编写新页面、组件、composable,实现数据获取(useFetch、useAsyncData),创建服务端路由与 API 端点,组织类型与自动导入,使用 Nuxt 模块与插件,以及配置渲染模式(SSR、SSG、SPA)时参考。

主要能力:包含 40+ 条规则,分 8 类并按影响优先级排列:数据获取(CRITICAL,前缀 data-)、自动导入与组织(CRITICAL,imports-)、服务端与 API 路由(HIGH,server-)、渲染模式(HIGH,rendering-)、状态管理(MEDIUM-HIGH,state-)、类型安全(MEDIUM,types-)、模块与插件(LOW-MEDIUM,modules-)、性能与部署(LOW,perf-)。规则涵盖如 useFetch 替代原生 fetch、唯一 key、懒加载、fetch 时转换数据、getValidatedQuery/readValidatedBody 配合 Zod、defineRouteMeta、useRuntimeConfig、routeRules 按路由渲染、useState、Pinia、类型导入路径等。

使用方式:阅读各规则文件获取详细说明与代码示例,如 rules/data-use-fetch.md、rules/imports-no-barrel-autoimport.md、rules/_sections.md。每个规则文件包含重要性说明、错误代码示例及解释、正确代码示例及解释、以及 Nuxt 相关补充说明。完整指南见 AGENTS.md。

适用场景:Nuxt 3/4 项目的开发、重构与代码生成,尤其是希望依据明确优先级改进数据获取、组织方式、服务端逻辑与渲染策略的团队。

限制:资料仅列出规则类别与名称,未逐一展开每条规则的完整内容;未提供安装命令、URL 使用方式、收费或价格信息,这些暂未提供。