SuperAPI AI 工具集

jalco-shadcn-registry

前端与建站

查看项目

更新于 10-16 06:19

技能介绍

用途:在开发 jalco ui 注册表基础设施、registry 条目或相关文档时使用。改动前必须阅读 .pi/skills/components-build/SKILL.md、AGENTS.md、registry.json、package.json 及 vercel-react-best-practices、vercel-composition-patterns、tailwind-design-system 等技能文件;必要时查看 components.json、public/r、registry/、components/open-in-v0-button.tsx、app/page.tsx。

主要能力:创建新 registry 条目;选择正确的条目类型(registry:component、registry:ui、registry:block、registry:hook、registry:lib、registry:page、registry:file、registry:theme、registry:style、registry:base、registry:item);更新 registry.json;校验 files、target、dependencies、registryDependencies;按 registry/[style]/... 组织条目;规划命名空间注册表;准备 MCP 与 Open in v0 兼容;编写安装与使用文档。

核心规则:registry.json 必须通过 https://ui.shadcn.com/schema/registry.json 校验,条目须符合 registry-item.json;shadcn build 默认在 public/r 生成条目负载。源文件放在 registry/[style]/[item-name]/...,内部引用用 @/registry/... 路径。每个文件条目须含 path 与 type,registry:page 和 registry:file 必须有 target。npm 包用 dependencies,仅开发用 devDependencies,shadcn 条目用 registryDependencies。title、description 须有意义。命名空间以 @ 开头,格式 @namespace/resource-name,配置在 components.json 的 registries 下。私有注册表须用 HTTPS 与环境变量凭据,不得提交令牌。Open in v0 不支持命名空间注册表、cssVars、css、envVars 及基于 header 的认证。MCP 兼容要求 registry.json 有效可发现、条目名用 kebab-case、依赖声明准确。

推荐流程:建 feat/<item-name> 分支,阅读 AGENTS.md 与相关技能,参考已有条目,选类型,建文件,更新 registry.json,核对依赖,在 components/docs/previews/<registry-name>.tsx 建预览卡,在 lib/docs.ts 加侧边栏条目(badge: "New",badgeAdded 为当天 ISO 日期),运行 pnpm previews:generate,经 /dev/screenshots 生成明暗截图存 public/previews/,运行 pnpm registry:build 与 pnpm build,测试本地端点,核对文档,按组件模板提 PR。

常用命令:pnpm install;pnpm dev;pnpm registry:build;pnpm dlx shadcn@latest view http://localhost:3000/r/<item-name>.json;pnpm dlx shadcn@latest add http://localhost:3000/r/<item-name>.json。

限制:条目须可安装、可读、可访问、精修、文档就绪,不得含模糊描述、臃肿依赖、不清晰 target、未记录的环境变量。