AI 技能（Skills）

uView Pro X 提供配套的 Agent Skills 技能包 uview-pro-x。把它装进 AI 编程助手后，助手会按本库的页面编写规范产出代码，而不是凭训练记忆猜写法：写 ux-* 组件前先查 API 卡片，写完再跑校验脚本把属性、事件用法校到 0 违规。

技能面向消费侧——只讲「怎么在项目里用 uview-pro-x 写页面」，不涉及组件库自身的实现与开发流程。

技能覆盖范围

能力	说明
接入	插件市场导入、easycom 配置、`main.uts` 注册、样式接入
页面脚本	UTS 组合式写法、类型陷阱、模板绑定规则、页面生命周期
页面样式	UCSS 选择器与属性红线、flex 布局陷阱、文本省略、主题取色
组件用法	七大分类速查表，以及 77 个组件的 API 卡片（属性 / 取值 / 事件 / v-model / 插槽）
多语言	语言包注册、`useLocale` API、默认语言优先级、组件内置文案联动
多主题 / 暗黑	主题注册、`useTheme` API、暗色板生成、页面联动
三端兼容	条件编译宏清单、三端红线表、症状 → 修法速查

安装

bash

pnpx skills add uview-pro/skills

安装后技能会落到 AI 客户端的技能目录，名称为 uview-pro-x。支持 Agent Skills 的客户端（Qoder、Claude Code、Cursor 等）加载后即可生效。

技能包同时开源在 uview-pro/skills。如果命令安装失败（网络受限、镜像不可用或客户端未识别），可直接到该仓库下载技能包，手动放进客户端的技能目录使用。

使用方式

不需要记命令，直接用自然语言描述需求即可，例如：

「用 uview-pro-x 写一个带主题切换的登录页」
「这个页面在 App 端白屏，帮我按三端红线排查一下」
「给列表页加上拉加载更多和返回顶部」

助手会按技能内的固定流程工作：

先查 references/spec/ 的接入与规范，有对应场景时直接套用 references/recipes/ 的配方；
写每个 <ux-*> 前先读 references/api/ux-<name>.md 卡片，卡上没有的写法不猜；
颜色一律取主题（$u-* SCSS 变量 / $u.color.*），不硬编码色值；
收尾运行校验器，error 清零才算完成。

技能目录结构

uview-pro-x/
├─ SKILL.md                     # 技能入口：适用场景、强制机制、工作流
├─ references/
│  ├─ README.md                 # 手册索引与权威源优先级
│  ├─ spec/                     # 规范正文（01 接入 … 07 主题与暗黑）
│  ├─ recipes/                  # 照抄配方：页面脚手架、滚动监听
│  └─ api/                      # 77 个组件 API 卡片 + model.json 快照
└─ scripts/
   ├─ verify-ux-usage.mjs       # 页面用法校验（写后门禁）
   ├─ gen-api-cards.mjs         # API 卡片与快照生成
   └─ update-api.mjs            # 一条命令更新快照与卡片（库维护者用）

手动校验

校验器也可以单独使用（Node ≥ 18，零第三方依赖）：

bash

node <技能目录>/scripts/verify-ux-usage.mjs pages/login/index.uvue

不传路径时默认扫描当前目录下的 pages/；传目录则递归扫描 *.uvue（跳过 uni_modules、node_modules、unpackage 等）；
默认只读技能内置的 API 快照，不依赖项目的组件库源码，源码加密的项目同样可用；
组件库源码可读时，可加 --lib <组件库目录> 现场比对实装库，版本不一致会提示「快照过旧」；
退出码：0 表示无 error（warn 不阻断），1 表示有 error。

与本站文档的关系

本站组件页是查阅型文档（完整 API 表格、示例、兼容性），技能是执行型规范（可被助手直接读取的约束、红线、配方与校验器）。两者内容同源；若出现冲突，以组件库源码与本站组件页为准。

下一步

接入第一个页面：快速开始
跨端限制：注意事项

AI 技能（Skills） ​

技能覆盖范围 ​

安装 ​

使用方式 ​

技能目录结构 ​

手动校验 ​

与本站文档的关系 ​

下一步 ​