SuperAPI AI 工具集

shadcn

前端与建站

查看项目

更新于 10-15 23:25

技能介绍

用途:在构建、组合、调试 shadcn/ui 组件,或初始化项目、切换设计系统预设、检索组件文档与示例时使用。组件以源码形式通过 CLI 加入项目。

主要能力:通过 CLI 查询项目配置与已装组件、搜索注册表、获取组件文档与示例 URL、添加或更新组件,并给出表单、布局、图标、样式等使用规范。

使用方式:所有命令须使用项目的包运行器,如 npx shadcn@latest、pnpm dlx shadcn@latest 或 bunx --bun shadcn@latest。常用命令包括 npx shadcn@latest info --json 查看项目上下文,npx shadcn@latest docs <component> 获取文档,npx shadcn@latest search 查找组件,npx shadcn@latest add <component> 安装,npx shadcn@latest init --preset <code> 初始化或切换预设。更新时先 --dry-run 与 --diff 预览,避免未经用户同意使用 --overwrite。项目上下文含 aliases、isRSC、tailwindVersion、base、iconLibrary、packageManager 等字段,导入与安装须遵循这些值。

适用场景:新增或组合组件、维护设计系统、排查样式与结构问题、从社区注册表引入组件并修正第三方硬编码导入路径。

限制:仅适用于明确匹配上述范围的 shadcn/ui 任务;输出不替代环境特定验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应先询问。注册表须由用户明确指定,不得代为默认。