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。