用途:为 AI 智能体和 LLM 提供 Next.js 应用的性能优化与最佳实践指引,在编写、重构、审查 Next.js 代码时激活。适用于 App Router 与 Pages Router,聚焦服务端组件(RSC)、Server Actions、API 路由处理器、Suspense 边界及 Next.js 专有 API(headers()、cookies()、after())。
主要能力:消除服务端瀑布流请求、并行化独立操作、设置战略性 Suspense 边界;Server Actions 的认证与授权、避免重复序列化、最小化 RSC 边界序列化、并行数据获取、用 React.cache() 去重、用 after() 执行非阻塞操作;以及避免 barrel 文件导入、判断服务端与客户端组件边界。技能还提供快速检查清单、复合模式说明和用于检测反模式的辅助脚本。
使用方式:采用渐进式披露结构以降低上下文占用。先阅读 AGENTS.md 获取全部规则的一句话概览,再按需加载对应参考文件,例如 prevent-waterfall-chains.md(1.1)、parallelize-independent-operations.md(1.2)、strategic-suspense-boundaries.md(1.3)、server-actions-security.md(2.1)、avoid-duplicate-serialization.md(2.2)、minimize-serialization.md(2.3)、parallel-data-fetching.md(2.4)、react-cache-deduplication.md(2.5)、use-after-non-blocking.md(2.6)、avoid-barrel-imports.md(3.1)、server-vs-client-component.md(3.2)。每个参考文件包含错误与正确示例、原因说明和性能影响指标。
适用场景:优化缓慢的 API 路由与 Server Action、为 Server Action 添加认证授权、处理 RSC 属性过大或数据重复、并行化数据获取、优化 barrel 导入、判断组件应为服务端还是客户端,以及对 Next.js 代码做性能与安全检查。
限制:不适用于 React 通用优化、构建配置(webpack、turbopack,除非属于 Next.js 专有)、通用 TypeScript/JavaScript 问题、部署与托管配置、测试配置。技能页面未提供具体安装命令、版本兼容范围与收费信息。