跳到正文
Codex DesignBETA

Codex 的 shadcn skill

shadcn skill 教 Codex 按维护者的本意使用 shadcn/ui:先在 registry 里找现成组件再写自定义标记,组合完整的组件,用语义化 token 而不是原始颜色值来设置样式。它包含在 OpenAI 的 Build Web Apps 插件里。

更新于 2026年11月12日 · 阅读约 3 分钟

速览

Skill 名称shadcn
来自OpenAI 的 Build Web Apps 插件
安装codex plugin add build-web-apps@openai-curated,或者在 Codex 里用 /plugins
Codex 何时使用在任何带 components.json 文件的项目里,或者你提到 shadcn/ui、registry 或 --preset 代码时
源码GitHub 上的 openai/plugins

它能做什么

开始之前,这个 skill 会运行 npx shadcn@latest info --json,让 Codex 了解你项目的配置和已经装了哪些组件。然后它遵循四条原则:优先用现有组件,组合而不是重造,先用内置变体再考虑自定义样式,使用语义化颜色。

它还强制执行一些具体规则,每条都有一个参考文件,附错误和正确的代码:

  • 样式: 用 gap-* 而不是 space-y-*,用 size-10 而不是 w-10 h-10,不手动写 dark: 颜色覆盖,条件类名用 cn()。
  • 表单: 布局用 FieldGroup 和 Field,校验用 data-invalid 和 aria-invalid,选项不多时用 ToggleGroup。
  • 结构: 每个 dialog、sheet 和 drawer 都有标题;卡片用齐全部组成部分;头像一定有 fallback。
  • 用组件而不是手写标记: 提示框用 Alert,空状态用 Empty,加载用 Skeleton,用 Badge 代替加了样式的 span,toast 用 sonner。

什么时候用

如果你的项目用 shadcn/ui,或者想让 Codex 新建一个这样的项目,就装上它。它能避免 AI 写 shadcn 代码最常见的问题:组件看起来没错,其实是用原始 div 和写死的颜色拼出来的,结果在深色模式下出问题,也和你的主题越来越不一致。

试一试

用 shadcn/ui 做一个设置页
用 shadcn skill。用 shadcn/ui 做一个账户设置页:个人资料表单(姓名、邮箱、头像)、通知开关,以及一个带确认对话框的危险操作区。只用现有组件和语义化颜色。

Claude Code 里能用吗?

指令是标准的 SKILL.md,所以可以把文件夹从 GitHub 复制到 ~/.claude/skills。Claude Code 不会运行开头那条注入项目上下文的 ! 命令,所以先让它运行 npx shadcn@latest info。

继续阅读

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