页面模板构建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c91d71f3/page-template-builder。
技能介绍
问题背景
在 smart-admin 或同类中后台里,列表、详情、表单、工作台往往由不同同学各自搭页面:有的把列配置写在 index.vue 里,有的在表格行上平铺 a-button,权限与 table-id 散落各处。结果是结构不一致、空错加载态遗漏、埋点与操作栏各写一套,评审和联调成本都偏高。
技能如何工作
本技能把「建页」当成信息采集 + 标准骨架输出两件事。你先说明页面类型(列表 / 详情 / 表单 / 工作台)、数据加载方式(分页、筛选、排序)、权限与路由,以及空 / 错 / 加载态的表现;执行时会按类型选骨架,并以 references/page-template.md 为基线。
固定产出是三件套:index.vue、components/、column.js。页面内划分 Header、Filter、Content、Footer,并显式覆盖五个状态块:loading、empty、error、success、forbidden。输出还包括区块结构图(文本)、状态流转、事件约定(查询、重置、刷新、导出),以及与技术栈一致的示例骨架;在 smart-admin 列表场景下会约束使用 admin-page-layout、API 从 src/api/** 引入、权限与 table-id 走常量文件、列配置只在 column.js 中维护且每列带 width,操作列命名为 operate 并用 more-button 承载行操作。
适用边界
技能侧重页面骨架与约定,不会替你实现具体业务接口或复杂交互细节。若项目不是 Vue + smart-admin 体系,仍需把输出骨架映射到你们自己的组件与目录规范;列宽、权限点命名等仍需与现有 permission-const.js、table-id-const.js 对齐后再落地。
使用场景
- 新接 smart-admin 列表需求,需要一次性定好 index.vue、components 与 column.js 三件套目录
- 详情或表单页要统一 Header/Filter/Content/Footer,并补齐 loading、empty、error 五态展示
- 列表要接分页筛选排序,且操作列必须用 more-button,不能把 options 平铺在表格行上
- 团队评审发现列配置写在页面内、缺 table-id 常量,需要按 SKILL 输出可落地的骨架与事件约定
适合人员
- 负责 smart-admin 列表迭代的前端,要把权限点、table-id 与 column.js 列宽规范固化到新页面
- 中后台 Tech Lead,希望新同学提交的页面都走 admin-page-layout 与统一五态,减少结构分歧
- 从 0 搭工作台或表单页的业务前端,需要先对齐查询/重置/刷新/导出等事件约定再写逻辑
- 维护 permission-const 与 table-id-const 的工程师,需要生成页时默认从 src/api 与常量目录引用