Comp Hub 组件脚手架
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3dc59d32/comp-hub-create。
技能介绍
要解决什么问题
在 comp-hub 上发布业务组件,不仅要写 index.vue,还要对齐平台的目录约定、双预览 Demo、README 标题校验和 comp.json 元数据。手写时容易漏掉 mini 与 full 预览的差异(固定尺寸 + 缩放 API vs 100% 继承)、main.js 在 Vue 3 下通过 Vue.app 注册 UI 库的方式,或 README 标题里混入平台禁止字符导致上传失败。
技能如何工作
本技能按官方规范 生成一整套可上传的组件骨架,典型流程包括:
- 确认 全局唯一 的组件名(建议
公司-业务域-组件名前缀命名,仅字母、数字、-、_) - 创建标准目录,生成入口
index.vue(自包含,import声明依赖即可) - 生成
demo/mini.vue:固定内容尺寸(如 320×240),使用$getScaleStyle/$onScaleChange做 contain 等缩放居中(仅预览环境存在,需判空) - 生成
demo/full.vue(或demo/full/多文件):width/height: 100%,不调用缩放 API - 生成符合标题规则的
README.md(属性、事件、示例、依赖、更新日志)与comp.json(name、version,语义化版本) - 若需 Element 等 UI 框架,生成
main.js(Vue 2 用Vue.use;Vue 3 用Vue.app.use)
资源引用须用 相对路径;第三方依赖无需打进组件包,平台会扫描 import 并按主版本匹配(Vue 2/3 不互通)。
适用边界与注意点
- 重复组件名会被平台识别,难以进入推荐/热门/最新列表;更新时改代码并 升版本号 重新上传即可,历史版本仍保留。
- mini 面板应 订阅优于轮询,在
beforeDestroy/onBeforeUnmount里取消$onScaleChange订阅,避免泄漏。 - README 标题不能以数字开头,且禁止
#、反引号及大量标点;这是上传硬约束,生成时必须遵守。
使用场景
- 业务线要把新的 Vue 业务组件提交到 comp-hub,需要按规范生成 index.vue、demo 与 comp.json。
- 列表页小窗预览里组件被裁切或留白,需要在 demo/mini.vue 固定尺寸并接入缩放居中 API。
- 组件上传因 README 标题含数字或禁用符号被拒,需要按平台标题规则重新生成文档结构。
- 预览要全局使用 Element 等 UI 库,需在根目录 main.js 用 Vue 2/3 约定方式注册插件。
适合人员
- 负责把业务 Vue 组件上架 comp-hub、并对齐目录与版本号的前端工程师
- 要求各团队用公司-业务域-组件名前缀命名、避免重名冲突的前端平台负责人
- 编写属性表与使用示例、且 README 必须通过平台标题校验的设计系统维护者
- 首次发布 comp-hub 组件、需要区分 mini 缩放预览与 full 全屏预览写法的前端开发者