用途:在构建、重设计、美化或重构 SvelteKit 页面与可复用组件时,提供以 shadcn-svelte、Bits UI 和 shadcn-svelte MCP 为依据的设计与实现流程,避免凭记忆编造组件或 API。
主要能力:先了解目标屏幕类型、受众、内容密度、品牌方向及是否保留既有视觉语言;在写 UI 代码前用发现工具检索;确定明确的视觉方向(字体、色彩逻辑、间距、层级、动效);将设计映射到 MCP 验证过的组件、区块、图表、文档与图标;输出符合 SvelteKit 与 Svelte 5 的代码,不使用 React props、JSX 或 shadcn/ui React 指南。
使用方式:需具备 shadcn-svelte-search、shadcn-svelte-get、shadcn-svelte-list、shadcn-svelte-icons、bits-ui-get 等 MCP 工具。若缺失,应明确说明并提供托管 https://shadcn.svelte-apps.me/mcp 或本地 stdio npx -y shadcn-svelte-mcp(Bun 用 bunx)的配置。以 shadcn-svelte-get 作为组件、区块、图表或文档页的事实来源;上游存在的库组件默认用官方 shadcn-svelte CLI 安装,不手写上游源码,可围绕已安装组件编写包装、组合或页面代码。页面级输出按设计概念、已验证构建块、SvelteKit 文件计划、实现组织;可复用组件按用途与状态、依赖的已验证原语或图标、公开 API 或变体、实现组织。
适用场景:SvelteKit 页面设计、视觉刷新、主题化、可复用 UI 开发,以及需要 MCP 验证组件决策的前端工作。
限制:不得编造组件名、CLI 命令或 props;MCP 不可用时仅可对照官方 shadcn-svelte 文档验证;shadcn-svelte-icons 仅用于 Lucide 图标;bits-ui-get 仅在 shadcn-svelte-get 暴露 tooling.bitsUi.exactName 或 docs.bitsuiName 时使用;两者重叠时标准用法优先 shadcn-svelte-get。需保留既有设计系统,兼顾桌面与移动布局,图标按钮加 aria-label,保留焦点状态与键盘导航;未要求动效库时优先 Svelte 内置 transition:、in:、out:、animate:。仓库 agents/ 提供 VS Code、Claude Code、Cursor、Windsurf/Devin、OpenCode 等编辑器代理格式及 AGENTS.md 片段。