Codex 的 React Best Practices skill
React Best Practices 给 Codex 一份来自 Vercel Engineering 的 React 和 Next.js 性能指南:八个类别共 64 条规则,按影响大小排序,每条都附错误和正确的代码。它包含在 OpenAI 的 Build Web Apps 插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | react-best-practices |
| 来自 | OpenAI 的 Build Web Apps 插件 |
| 安装 | codex plugin add build-web-apps@openai-curated,或者在 Codex 里用 /plugins |
| Codex 何时使用 | 编写、审查或重构 React 组件或 Next.js 页面、数据获取或打包体积时 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
SKILL.md 是一份快速索引。每条规则在 rules/ 里都有单独的文件,写明为什么重要,并附错误示例、正确示例和参考资料。AGENTS.md 则把所有规则完整展开在一份文档里。
各个类别,按影响从高到低:
- 消除请求瀑布: 互不依赖的工作用
Promise.all(),把await挪到真正需要它的分支里,用 Suspense 流式渲染。 - 打包体积: 直接导入而不是从 barrel 文件导入,重组件用
next/dynamic,分析脚本在 hydration 之后再加载。 - 服务端: 给 server action 做身份验证,每个请求用
React.cache(),传给客户端组件的 props 尽量小。 - 客户端数据获取: 用 SWR 去重,滚动监听用 passive,
localStorage带版本号。 - 重复渲染: 在渲染时推导状态,而不是放在 effect 里,用函数式
setState,不在组件内部定义组件。 - 渲染: 长列表用
content-visibility,用三元表达式代替&&,加载状态用useTransition。 - JavaScript: 用
Set和Map查找,提前 return,用toSorted()。 - 进阶模式: 把事件处理函数放进 ref,每次 App 加载只初始化一次。
什么时候用
如果你用 React 或 Next.js 开发,希望 Codex 写代码时避开低效的写法,或者用这些规则审查已有的 App,就装上它。Build Web Apps 插件里的测试 skill 在较大的 React 改动之后也会把 Codex 引到这里。
试一试
审查 Next.js App 的性能
用 react-best-practices skill。审查这个 Next.js 项目 app/ 目录里的性能问题。先看请求瀑布和打包体积,列出每个问题以及它违反的规则,然后修复关键问题。
Claude Code 里能用吗?
能。这个 skill 全是普通的 Markdown 规则,不依赖 Codex 专有的工具,所以把文件夹从 GitHub 复制到 ~/.claude/skills 就能照常使用。