SuperAPI AI 工具集

shadcn-component-boundaries

设计与创作

查看项目

更新于 10-15 17:31

技能介绍

用途:在创建、移动、包装或审查使用 shadcn 的项目的 UI 组件时加载本技能,强制注册表组件与产品组件的边界。

主要能力:从 components.json 解析 components 与 ui 别名,不假设 components/ 或 src/components/;保留 ui 目录给从 shadcn 或兼容注册表安装的原语;禁止把产品自有包装、组合、区块、领域组件或功能行为放入 ui 目录;可复用产品组件放 common/,功能组件放命名功能目录或与功能同置;通过包装原语而非修改原语来组合;依赖保持单向:feature → common → ui,ui 不得反向导入;使用全局样式表中的语义 token;配置 @shadcn/lint 时,shadcn/no-restyle 约束 ui 边界,调用点可经 className 传布局类,外观来自 variants 与 sizes,需新增 variant 而非在调用点重设样式。

使用方式:读取 components.json 解析别名;创建自定义标记前先搜索已安装原语;按归属表分类;放置组件;验证 ui 中无产品文件且无反向导入。归属决策:注册表原语放解析出的 ui 目录;可复用产品组件放 <components>/common/;功能组件放 <components>/<feature>/ 或功能同置;路由或页面组合放框架路由/页面目录;主题 token 放全局样式表变量。

限制:具体命令、配置细节与边界案例见 references/placement-examples.md,资料未提供更多实现细节。