跳到正文
Codex DesignBETA

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 就能照常使用。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。