用途:Shark UI 是基于 Ark UI、采用 shadcn 式开发体验的组件注册表。该技能用于为 UI 任务挑选合适的 Shark 原语,编写符合 Ark UI 模式(由 Shark 封装)的正确用法代码,包括导入、组合与 props,并避免在未查证 Shark 文档与示例的情况下套用 Radix/shadcn API。
主要能力:覆盖覆盖层、菜单、弹出框、抽屉、对话框、选择器、组合框、表单字段、侧边栏等组件;提供组件文档、注册表示例与实现源码作为权威参考,并包含面向 LLM 的路由与仓库约定。
使用方式:先明确意图,查阅 references/component-registry.md 定位组件,阅读对应 MDX 的安装、结构与 API 表,再打开至少一个 registry/react/examples/<component>/example-*.tsx 参考组合方式;行为不清时阅读 registry/react/components/<component>.tsx。安装命令为 npx shadcn@latest add @shark/<component>,或使用 pnpm dlx shadcn@latest add https://shark.vini.one/r/<component>.json。仓库内导入路径为 @/registry/react/components/<component-name>,消费方安装后通常为 @/components/ui/...。
限制:不涉及 Next.js 应用路由、营销页面及非注册表应用代码,除非用户明确要求;不编辑 registry.json 生成的载荷。不得臆造 Shark 或 Ark API,需从文档或源码确认导出与结构;组合框等列表原语需使用 useFilter 与 useListCollection 并传入 collection;图表需正确接线 ChartTooltip;需保留无障碍标签、角色与错误语义。部分组件可能尚未进入 registry.json,应以 references/component-registry.md 的 CLI 安装名为准。