用途:该技能用于在 Vue 3 项目中使用 Vant 移动端组件库时提供结构化指导,适用于安装初始化、移动端 UI 实现、组件用法查询、主题定制以及现有 Vant 代码的审查与修复。触发场景包括 Vant 安装与项目初始化、van-button、van-cell、van-form、van-dialog、van-popup、van-toast 等组件使用、ConfigProvider 与 theme-vars 主题定制、移动优先页面结构与表单流程,以及将通用 Vue 3 UI 改写为 Vant 组件。
主要能力:技能按请求领域组织内容,分为快速开始与安装、组件实现、全局配置与主题、API 查询、模板脚手架五类。本地覆盖的组件示例包括 Button、Cell、Form、Dialog、Popup、Toast;主题与全局配置涉及 ConfigProvider 和 theme-vars;API 摘要涵盖组件与 ConfigProvider。
使用方式:先识别请求所属领域,再加载最小相关文件集。安装类请求参考 examples/getting-started/installation.md、basic-usage.md 与 templates/project-setup.md;组件请求加载 examples/components/ 下对应文件;主题请求加载 api/config-provider.md 与 examples/advanced/theme-customization.md;API 查询加载 api/components.md。回答时保持 Vue 3 Composition API 与 script setup 风格,导入来自 vant,模板使用 van- 组件,必要时导入 vant/lib/index.css。
适用场景:Vue 3 移动端项目搭建、触摸优先的交互与表单流程、组件属性事件方法查询、全局主题与暗色模式配置。
限制:本地仅覆盖上述组件,未覆盖的组件需通过 references/official-mapping.md 路由至官方指南,并明确说明本地无专用示例文件;不得引用不存在的本地文件,不得混用 Element Plus、Ant Design Vue 等其他 UI 库。官方入口为 https://vant-ui.github.io/ 与 https://vant-ui.github.io/vant/#/zh-CN。