Agent Skills
返回列表
Comp Hub 组件脚手架

Comp Hub 组件脚手架

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 标题里混入平台禁止字符导致上传失败。

技能如何工作

本技能按官方规范 生成一整套可上传的组件骨架,典型流程包括:

  1. 确认 全局唯一 的组件名(建议 公司-业务域-组件名 前缀命名,仅字母、数字、-、_)
  2. 创建标准目录,生成入口 index.vue(自包含,import 声明依赖即可)
  3. 生成 demo/mini.vue:固定内容尺寸(如 320×240),使用 $getScaleStyle / $onScaleChange 做 contain 等缩放居中(仅预览环境存在,需判空)
  4. 生成 demo/full.vue(或 demo/full/ 多文件):width/height: 100%,不调用缩放 API
  5. 生成符合标题规则的 README.md(属性、事件、示例、依赖、更新日志)与 comp.json(name、version,语义化版本)
  6. 若需 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 全屏预览写法的前端开发者