SuperAPI AI 工具集

react-best-practices

前端与建站

查看项目

更新于 10-15 21:42

技能介绍

用途:该技能是面向 React 与 Next.js 应用的性能优化规则集,用于在编写组件、实现数据获取、代码评审、重构、减小打包体积或优化加载时间时提供参考。规则 fork 自 Vercel Engineering,由 gracefullight 调优,共 42 条,分 8 类并按影响优先级排列,可指导自动重构与代码生成。

主要能力:按优先级分为消除瀑布流(async-,CRITICAL)、打包体积优化(bundle-,CRITICAL)、服务端性能(server-,HIGH)、客户端数据获取(client-,MEDIUM-HIGH)、重渲染优化(rerender-,MEDIUM)、渲染性能(rendering-,MEDIUM)、JavaScript 性能(js-,LOW-MEDIUM)、高级模式(advanced-,LOW)。部分规则由 Biome linter 强制,如 noBarrelFile、noReExportAll、noLeakedRender、useTopLevelRegex。

项目特定用法:API 层使用 Orval + React Query,Orval 从 OpenAPI 规范生成类型安全的 React Query hooks,客户端组件应使用生成的 hooks 而非 RSC 数据获取;RSC 组件只处理布局、SEO 元数据并传递静态 props。Next.js 已开启 React Compiler(next.config.ts 中 reactCompiler: true),自动处理 memoization,仅在分析出瓶颈或计算确实昂贵时才手动使用 useMemo/useCallback。

使用方式:按需阅读各规则文件获取解释与代码示例,例如 rules/async-parallel.md、rules/bundle-dynamic-imports.md、rules/_sections.md;完整展开版见 AGENTS.md。

适用场景与限制:适用于新组件/页面编写、数据获取实现、性能审查、重构及体积与加载优化。资料未提供安装命令、收费与平台信息。