SuperAPI AI 工具集

w-shadcn

前端与建站

查看项目

更新于 10-15 15:20

技能介绍

w-shadcn 是一个面向 monorepo 项目的 UI 组件安装与扩展技能,主要用于在共享 UI 包中引入或扩展 shadcn/w-ui 基础组件。

用途 该技能解决的是在 monorepo 架构下安装 shadcn 基础组件时的路径与规范问题。它强调组件应安装到 components.json 所指定的共享 UI 包中,而不是散落在各个应用内。以 Basilic 为例,目标路径为 packages/w-ui/src/components/。

主要能力

  • 安装或扩展 shadcn 基础组件(primitive)。
  • 遵循 shadcn-v3 规范。
  • 使用 monorepo 导入路径:@repo/w-ui/components/* 以及该包提供的 cn。
  • 对罕见基础组件,使用 @repo/w-ui/base,而不是 @base-ui/react、@radix-ui/* 或已删除的 @repo/w-ui/radix。
  • 保持 components.json 中的 "style": "base-vega"。
  • 使用 render 配合 data-slot / data-open 进行组合,而不是 asChild / data-state。

使用方式 在需要安装或扩展基础组件时使用该技能。安装位置以 components.json 为准,Basilic 示例为 packages/w-ui/src/components/。导入时使用 @repo/w-ui/components/* 和该包的 cn。只有在不确定组件变体或遇到安装错误时,才使用 shadcn MCP。组件就绪后,如果任务涉及的是界面(surface)而不仅是组件,可用 /w-ui 重塑屏幕。对改动的文件运行 lint。如果行为或命令发生变化,参考 /w-docs 文档。

适用场景 适用于采用 monorepo 且使用 shadcn/w-ui 共享 UI 包的项目,需要在统一位置安装或扩展基础组件,并保持导入路径与组合方式一致。

限制 资料未提供该技能的具体安装命令、依赖版本、支持平台、收费方式或效果说明,这些信息暂未提供。使用时应严格遵循资料中给出的路径、导入方式与组合约定,不擅自替换为其他 UI 库或已删除的路径。