SuperAPI AI 工具集

svelte-frontend

前端与建站

查看项目

更新于 10-16 01:08

技能介绍

用途:该技能为 Windmill 前端(frontend/)编写或修改 Svelte 代码时提供项目专属规范,约束组件选择、设计系统与验证流程;通用 Svelte 5 语法(runes、snippets、事件处理)需借助 Svelte MCP 服务器。

主要能力与要求:写 UI 前必须先查找既有组件,frontend/src/lib/components/common/index.ts 是设计系统导出入口,且组件树含 1600+ 组件,应优先复用而非新建;按构建内容查阅 frontend/brand-guidelines.md 的对应章节(组件、按钮、色彩、排版、间距、阴影、图标、文案)。必须使用 Windmill 设计系统组件,禁止裸 HTML 元素。示例:Button 来自 $lib/components/common,props 含 variant(accent/accent-secondary/default/subtle)、unifiedSize(2xs/xs/sm/md/lg)、startIcon、iconOnly、disabled,size 已弃用;TextInput 支持 bind:value、placeholder、disabled、error、size;Select 从 $lib/components/select/Select.svelte 导入,支持 items、bind:value、placeholder、clearable、size。图标统一用 lucide-svelte,禁止内联 SVG。样式使用 Tailwind CSS,禁止自定义 CSS,颜色与表面使用 Windmill 主题类;使用组件前阅读其 props JSDoc。表单组件并排放置时应使用统一尺寸系统。

功能埋点:新增面向用户的 UX 需提出 feature_usage 计数器,先读 docs/feature-telemetry.md;logFeatureUsage() 来自 $lib/utils/featureUsage,且 (feature, kind) 必须在后端允许列表中注册,否则事件被静默丢弃;披露文案保持在类别层级。

工具与验证:使用 Svelte MCP 工具(list-sections 先调用、get-documentation、svelte-autofixer 必须对全部 Svelte 代码反复调用至无问题、playground-link 仅在用户确认且代码未写入项目文件后使用)。改动后用 Playwright MCP 驱动运行中的前端确认效果,流程见 frontend/AGENTS.md,devbox 用 headless,有显示时用 headed。其余细节暂未提供。