Agent Skills
返回列表
💻

Uniwind

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/uni-stack-uniwind-uniwind。

技能介绍

要解决什么问题

在 React Native 里写样式往往要维护大量 StyleSheet 对象,和 Web 端 Tailwind 的工作流也对不上。若你从 NativeWind 迁来,还会遇到 v3 指令、cssInterop、运行时扫描等与 Tailwind CSS v4 不兼容的做法。Uniwind 的目标很明确:在 React Native 0.81+ / Expo SDK 54+ 上,用 v4 的 @import 'tailwindcss' 与 @theme,在构建期把 className 编译成样式,避免运行时扫描开销。

技能如何帮你落地

安装与排错时,技能会按 references/setup.md、troubleshooting.md 等路由,强调几条容易踩坑的硬规则:

  • 不要动态拼接 className(如 bg-${color}-500),扫描只在构建期进行。
  • 核心组件(View、Text、Pressable 等)已内置 className,不要用 withUniwind 再包一层,否则会破坏行为;withUniwind 只用于 expo-image、expo-blur、moti 等第三方组件。
  • color、tintColor、thumbColor 等非 style 颜色属性,必须用 {prop}ClassName 搭配 accent- 前缀 的完整类名字面量。
  • 主题走 global.css 的 @theme / @layer theme,用 Uniwind.setTheme(),且各主题 variant 定义的 CSS 变量集合必须一致。

涉及组件绑定、主题、tailwind-variants、cn() 去重、平台变体或 Pro 能力时,技能会指向对应 reference,并要求不确定时对照官方文档而非臆测 API。

适用边界

仅支持 Tailwind v4;不支持 tailwind.config.js 旧模式。用户版本低于 Uniwind 1.7.0+(Pro 1.2.1+)时应建议升级。LayoutDirection(1.8.0+)、ScopedVariables(1.11.0+ / Pro 1.6.0+)有版本门槛。从 NativeWind 的整体迁移应使用单独的 migrate-nativewind-to-uniwind 技能,本技能不替代那条迁移路径。

使用场景

  • 新建 Expo SDK 54 项目,要在 Metro 里配置 withUniwindConfig 并写好 global.css 入口
  • 按钮或 Image 的 tintColor 上色不对,需要改成对应 prop 的 accent- 类名写法
  • 深色模式切换后报 CSS 变量缺失,要核对各主题 variant 变量集合是否一致
  • 给 expo-image 或 moti 组件接上 className,需确认只用 withUniwind 包第三方而非 RN 内置组件

适合人员

  • 维护 RN 0.81+ 业务页的工程师,想把页面样式改成与 Web 一致的 Tailwind 工具类写法
  • 从 NativeWind 迁到 v4 的移动端开发者,需要分清哪些 API(cssInterop、动态 className)必须停用
  • 负责 Expo 发版的同学,要在发版前排查 Metro 外层包装顺序和 accent- 颜色属性绑定
  • 接入第三方 RN UI 库的成员,需要为不支持 className 的组件单独用 withUniwind 做样式桥接