/ui-page
快速生成 UI 页面骨架。新增页面时使用。
快速 UI 页面生成
生成页面 "$ARGUMENTS":
规则
- 使用 shadcn/ui 组件,不自定义样式
- 使用项目现有的 layout 结构
- 列表用 Table,表单用 Form + zod,弹窗用 Dialog
- 必须处理三种状态:加载中(Skeleton)、空数据、错误
- 必须连接真实 API,不用 mock 数据
- 不做样式美化
页面类型速查
| 类型 | 组件组合 |
|---|---|
| 列表页 | Table + Pagination + 搜索 Input + 新增 Button |
| 详情页 | Card + Tabs + 返回 Button |
| 表单页 | Form + zod schema + Submit Button + Toast |
| 仪表盘 | Card 网格 + 数字统计 |
步骤
- 读取项目
docs/product-spec.md和docs/design-spec.md(如存在):- 从 product-spec 页面注册表(§4.1)获取页面类型、路由、前后页面关系
- 从 product-spec 状态矩阵(§4.2)获取该页面必须处理的所有状态
- 从 product-spec 页面间数据流(§4.3)获取数据来源和传递方式
- 从 design-spec Token 系统(§2)和组件规范(§4)获取样式约束
- 如果文件不存在,回退到与用户确认页面类型和数据来源
- 确认页面类型和数据来源(API 接口),与 product-spec 交叉验证
- 检查 shadcn/ui 是否已安装需要的组件,未安装则先安装
- 生成页面组件 + 对应的 API Route(如果还没有)
- 跑通数据流,验证功能正确
IMPORTANT:功能优先。不要花时间在颜色、间距、动画上。