vercel-react-best-practices

Vercel React 最佳实践

此技能是对 react-best-practices 的兼容性封装。它的存在是为了让旧工作流和特定平台的设置继续正常运行，同时避免让 React 性能方向看起来像是有两个同等优先的默认技能。

何时使用此技能

• 用户或工具明确要求使用 vercel-react-best-practices
• 设置或同步流程要求存在旧版文件夹／名称
• 需要在将实际工作转交给 react-best-practices 的同时保留向后兼容性

不要将此技能作为一般 React 或 Next.js 性能问题的默认选项。

说明

步骤 1：确认别名意图

检查请求是否确实依赖这个确切的别名名称。

仅在以下情况使用此别名：

• 用户直接提到了它
• 脚本／工具界面按字面引用了它
• 任务涉及迁移或兼容性问题

否则，请切换到 ../react-best-practices/SKILL.md。

步骤 2：转到规范技能

先使用别名侧的资料包，然后转到规范的 React 性能指南：

• 别名路由说明：./references/alias-routing.md
• 测量与路由转出说明：./references/measurement-route-outs.md
• 规范技能：../react-best-practices/SKILL.md
• 深入参考：../react-best-practices/AGENTS.md
• 相关边界：
  • 全局状态架构请参阅 ../state-management/SKILL.md
  • 无障碍问题修复请参阅 ../web-accessibility/SKILL.md
  • 非 React 全局性能问题请参阅 ../performance-optimization/SKILL.md

步骤 3：在输出中保留兼容性

如果你是通过别名名称激活的，请说明规范指南现已位于 react-best-practices 中，以便后续维护统一到一个主要入口。

示例

示例 1：明确请求使用旧名称

输入："使用 vercel-react-best-practices 审查我们的 Next.js 仪表板为何运行缓慢。" 输出：确认使用了该别名，然后应用 react-best-practices 中关于瀑布流、打包体积和 RSC 边界的指南。

示例 2：一般 React 性能问题

输入："我们的 React 应用重新渲染太频繁，而且 Next.js 页面很慢。" 输出：不要继续使用此别名。直接转到 react-best-practices。

最佳实践

1. 将其视为重定向层，而非独立的知识库。
2. 保持触发措辞范围狭窄，让规范技能处理常规 React／Next.js 请求。
3. 更新底层指南时，优先更新 react-best-practices。
4. 在文档／设置界面中明确说明规范状态与兼容性状态的区别。

参考资料

• ./references/alias-routing.md
• ./references/measurement-route-outs.md
• ../react-best-practices/SKILL.md
• ../react-best-practices/AGENTS.md
• ../state-management/SKILL.md
• ../web-accessibility/SKILL.md
• ../performance-optimization/SKILL.md