Arco Design Vue 组件开发指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b0e06ef2/arco-design-vue。
技能介绍
这类工作里容易踩的坑
在 Vue 3 项目里接 Arco Design(@arco-design/web-vue)时,常见问题不是「会不会用组件」,而是 导入路径、模板属性命名、表单校验写法 与官方 Vue 实现不一致。混用 React 文档里的 Form.useForm、JSX 子节点,或给日期组件塞 Moment.js,都会让 AI 生成的代码直接无法编译或样式缺失。
技能如何组织答案
本技能把 Arco 的约定写死在一套 关键约定 里:根包导入组件与服务、图标走 @arco-design/web-vue/es/icon、全量样式用 arco.css 或按需 style/css.js;模板里组件标签带 a- 前缀,属性用 kebab-case,事件与 v-model / v-model:visible 等命名形式按 Vue 语法来写。需要某个组件的 props、事件、插槽或示例时,按 Skill 索引 加载对应 *.md(如 table.md、form-patterns.md),而不是凭 React 或别的框架记忆编造 API。
索引覆盖 安装与 ConfigProvider、主题与国际化,以及 Button、Table、Form、Upload 等全量组件分类,另有 表单 / 表格 / 弹窗模式 与受控值、响应式布局等专题,便于在复杂页面里对齐实现方式。
边界与注意点
技能侧重 Vue 3 + Composition API 下的 Arco 写法与文档式参考,不替代官方 changelog 与版本迁移说明。若项目仍是 Vue 2 或不用 Arco,应换用对应技能;业务组件封装、构建链(Vite/Webpack 插件细节)以 getting-started.md、theming.md 等条目为准,缺文件时不要臆造组件 API。
使用场景
- 新页面要用 Arco 的 Table 做远程分页、列筛选和行选择,需要对照索引里表格模式与 `table.md` 的属性和插槽写法。
- 管理后台表单含动态字段与统一校验,要让生成代码使用 `:model`、`field` 规则和子控件的 `v-model`,而不是 React 表单 API。
- 接入暗黑主题或按需加载样式时,需要按 `theming.md` 与 getting-started 中的 Less 变量和 `style/css.js` 路径组织引入。
- 在 Composition API 的 SFC 里批量使用 Menu、Layout、Breadcrumb 搭导航骨架,需遵守 `a-` 前缀与 kebab-case 事件命名。
适合人员
- 维护字节系或 Arco 中后台的 Vue 3 前端,希望 AI 输出与官方 Vue 包一致的导入与模板约定
- 负责把设计稿落成 Form、Upload、DatePicker 等录入组件的工程师,需要按 skill 索引查 props 而非混用 React 文档
- 带新人做 Arco 项目的技术负责人,想用统一的架构约定(`architecture.md`)约束 SFC 结构与 v-model 用法
- 从 React + Arco 迁到 `@arco-design/web-vue` 的开发者,需要明确禁止 Form.useForm 等跨框架 API