Agent Skills
返回列表
💻

json-render Shadcn 组件集

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-json-render-shadcn。

技能介绍

问题在哪

如果你用 json-render 把 JSON catalog 描述成 UI,却要自己为每个控件写 schema 和 React 映射,工作量会集中在「组件清单是否完整、命名是否和提示词一致」上。shadcn/ui 生态里组件很多,但 json-render 需要的是可放进 catalog 的定义与能直接挂载 ActionProvider 的实现,二者还要能拆开用在服务端生成 prompt。

这套技能怎么帮上忙

@json-render/shadcn 提供 36 个基于 Radix UI + Tailwind 的预置组件,并明确分成两个入口:

  • @json-render/shadcn/catalog 导出 shadcnComponentDefinitions,无 React 依赖,适合服务端拼 catalog / prompt。
  • @json-render/shadcn 导出 shadcnComponents,即 React 实现侧。

用法上的关键约束也很清楚:只挑选应用实际用到的组件写入 definitions,不要 spread 整库。表单类控件支持 checks(类型 + 消息)和 validateOn(change / blur / submit);setState、pushState、removeState、validateForm 等动作写在 React schema 里,由 ActionProvider 自动处理,catalog 里不必重复声明。

组件面覆盖布局(Card、Stack、Grid)、导航(Tabs、Accordion)、浮层(Dialog、Drawer)、内容与表格、反馈态,以及完整的表单输入族(Input、Select、Checkbox 等),并可在标准组件旁扩展自定义组件。

边界与前提

实现侧使用内置打包的 shadcn/ui 原语,不是你项目 components/ui/ 里那套;样式依赖 Tailwind,宿主应用需先配置好。事件语义在文档里有约定(如 input 的 change/blur,button 的 press)。若你的目标是「只用自家 UI 库、零 Tailwind」,需要自行替换实现或只引用 catalog 定义做协议参考。

使用场景

  • 在服务端根据用户意图生成 JSON UI 描述时,只用 catalog 入口挑选 Card、Form 相关 definitions,避免把 React 打进 prompt 管线。
  • 做 json-render 演示页时,从标准定义里显式勾选 Tabs、Dialog、Table,而不是 spread 全部 36 个组件进 catalog。
  • 需要模型驱动 setState / validateForm 的问卷或配置向导时,为 Input、Select 配置 checks 与 validateOn,交给 ActionProvider 处理校验写入。
  • 在既有 json-render 应用里增补 Drawer、Pagination 等导航与浮层组件,并与自定义业务组件并列注册到同一 catalog。

适合人员

  • 维护 json-render + React 管理后台的前端,希望用现成 shadcn 映射减少手写 component map 的同事
  • 负责 LLM 生成 UI JSON 的后端/全栈,需要在无 React 环境导出 `shadcnComponentDefinitions` 的人
  • 做原型或内部工具的工程师,要快速搭带 Dialog、表单校验的模型可控界面
  • 正在对齐 json-render catalog 与提示词字段名的技术写作者,需要一份与实现一致的组件清单参考