Codex 的 Building Native UI skill
building-native-ui skill 是 Expo 团队写的 Expo Router App 开发指南:原生导航、控件、样式、动画和视觉效果,遵循 Apple 的人机界面指南(Human Interface Guidelines)。它包含在 Codex 的 Expo 插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | building-native-ui |
| 来自 | Expo 团队的 Expo 插件 |
| 安装 | codex plugin add expo@openai-curated,或在 Codex 里运行 /plugins |
| Codex 何时使用 | 在 Expo Router App 里构建或重新设计界面、导航、控件、动画或视觉效果时 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
这个 skill 的第一条规则是:永远先试 Expo Go。只有当 App 需要本地原生模块、Apple 的扩展目标(比如小组件)、第三方原生模块,或者 app.json 表达不了的原生配置时,Codex 才会改用自定义构建。
然后它为 Codex 写的代码定下默认做法:
- 库: 用
expo-image配合sf:来源显示 SF Symbols,用expo-audio和expo-video代替expo-av,用expo-glass-effect做液态玻璃,用process.env.EXPO_OS代替Platform.OS。 - 布局: 每个路由的第一个子元素用带
contentInsetAdjustmentBehavior="automatic"的ScrollView,不用SafeAreaView;优先用 flex gap 而不是 margin;优先用useWindowDimensions而不是Dimensions.get()。 - 样式: 内联样式,用 CSS
boxShadow代替旧的 shadow 属性,使用连续曲率圆角,数据文字设为selectable。 - 导航: 在
_layout.tsx文件里定义 stack,用 stack 标题而不是自定义标题,Link带预览和上下文菜单,模态框和表单 sheet 都作为 stack 界面。
它还给出了一个标准的路由布局:原生 Tab,每个 Tab 里嵌一个 stack。14 份参考文件涵盖动画、原生控件、表单 sheet、渐变、图标、媒体、路由、搜索、存储、Tab、工具栏、模糊和玻璃效果、WebGPU 配合 Three.js,以及缩放转场。
什么时候用
用 Expo Router 做以 iOS 为主的 App、又希望界面像原生 App 而不是套壳网页时,就用它。它能防止 Codex 用到已经从 React Native 中移除的模块,也能避免在已有原生组件的地方自己造模态框和标题。
试一试
做一个原生质感的 Expo 界面
使用 building-native-ui skill。用 Expo Router 做一个菜谱 App:Recipes 和 Search 两个原生 Tab,一个带链接预览和上下文菜单(Share、Delete)的列表,以及一个用来添加菜谱的表单 sheet。要能在 Expo Go 里运行。
Claude Code 里能用吗?
能。这个 skill 只是普通的指令和 Markdown 参考文件,没有 Codex 专属的工具,所以可以把文件夹从 GitHub 复制到 ~/.claude/skills。