用途:为 React 与 Next.js 应用提供性能优化规则集,在编写新组件/页面、实现数据获取、审查性能问题、重构现有代码、优化包体积或加载时间时参考。
主要能力:共 62 条规则,分为 8 类并按影响优先级排序。1)消除瀑布流(CRITICAL,前缀 async-),如把 await 移入实际使用的分支、独立操作使用 Promise.all()、API 路由中提前启动 Promise 延后 await、用 Suspense 流式输出。2)包体积优化(CRITICAL,bundle-),如直接导入避免 barrel 文件、用 next/dynamic 加载重组件、水合后加载分析/日志、按需加载模块、悬停/聚焦预加载。3)服务端性能(HIGH,server-),如像 API 路由一样鉴权 server actions、用 React.cache() 做请求内去重、LRU 跨请求缓存、减少传给客户端组件的数据、并行取数、用 after() 处理非阻塞操作。4)客户端数据获取(MEDIUM-HIGH,client-),如 SWR 去重、去重全局事件监听、滚动使用 passive 监听器、localStorage 数据版本化与最小化。5)减少重渲染(MEDIUM,rerender-),如抽离昂贵计算到 memo 组件、用原始类型依赖、订阅派生布尔值、渲染期派生状态、函数式 setState、useState 惰性初始化、用 startTransition、用 ref 处理瞬时值。6)渲染性能(MEDIUM,rendering-),如长列表用 content-visibility、提取静态 JSX、降低 SVG 精度、用内联脚本处理仅客户端数据、资源提示预加载、脚本加 defer/async。7)JavaScript 性能(LOW-MEDIUM,js-),如批量 DOM/CSS 变更、用 Map 索引、缓存属性访问与函数结果、合并迭代、用 Set/Map 做 O(1) 查找、用 toSorted() 保持不可变。8)高级模式(LOW,advanced-),如用 ref 存事件处理器、应用每次加载初始化一次。
使用方式:阅读 rules/ 目录下的单条规则文件(如 rules/async-parallel.md),每条含原因说明、错误示例、正确示例与补充参考;完整指南见 AGENTS.md。开发相关命令:python -m scripts build(编译规则到 AGENTS.md)、python -m scripts validate(校验规则文件)、python -m scripts extract-tests(提取测试用例供 LLM 评估)。
适用场景:React/Next.js 项目的性能审查、重构与代码生成辅助。
限制与来源:资料未提供收费、价格与平台支持信息;规则以 Vercel 官方工程实践为基础,由 @shuding 在 Vercel 创建,来源为 vercel-labs/agent-skills。