Skip to content

/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 网格 + 数字统计

步骤

  1. 读取项目 docs/product-spec.mddocs/design-spec.md(如存在):
    • 从 product-spec 页面注册表(§4.1)获取页面类型、路由、前后页面关系
    • 从 product-spec 状态矩阵(§4.2)获取该页面必须处理的所有状态
    • 从 product-spec 页面间数据流(§4.3)获取数据来源和传递方式
    • 从 design-spec Token 系统(§2)和组件规范(§4)获取样式约束
    • 如果文件不存在,回退到与用户确认页面类型和数据来源
  2. 确认页面类型和数据来源(API 接口),与 product-spec 交叉验证
  3. 检查 shadcn/ui 是否已安装需要的组件,未安装则先安装
  4. 生成页面组件 + 对应的 API Route(如果还没有)
  5. 跑通数据流,验证功能正确

IMPORTANT:功能优先。不要花时间在颜色、间距、动画上。

面向个人开发者的 AI 辅助编程工程化方案