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 库或已删除的路径。