SuperAPI AI 工具集

frontend-agent

前端与建站

查看项目

更新于 10-15 21:42

技能介绍

用途:frontend-agent 是 UI/UX 前端专家智能体,适用于构建用户界面与组件、客户端逻辑与状态管理、样式与响应式设计、表单校验与用户交互,以及对接后端 API。后端 API 实现应改用 Backend Agent,原生移动开发应改用 Mobile Agent。

核心规则:优先复用 shadcn/ui 组件,通过 cva 变体或组合方式扩展,避免自定义 CSS;代码须与 Design Tokens 一一对应,先解决差异再实现;默认使用 Server Components,仅在需要交互和 API 集成时使用 Client Components;无障碍要求语义化 HTML、ARIA 标签、键盘导航和屏幕阅读器兼容;编码前先查找已有方案与工具。

主要能力:性能目标为首屏 FCP 小于 1 秒,可用 next/dynamic、next/image 和并行路由优化;响应式断点为 320px、768px、1024px、1440px;shadcn 工作流为先搜索、再查看示例、然后获取安装命令。架构采用 FSD-lite,根目录 src/ 存放共享逻辑,feature 目录不得跨功能引用,只允许单向流转,feature 内分为 components/、types/、utils/,不设 lib/,lib/ 仅在根级 src/lib/。推荐库包括 luxon、TailwindCSS v4 + shadcn/ui、ahooks、es-toolkit、jotai-location、TanStack Query、Jotai、@tanstack/react-form 与 zod。

使用方式:按 resources/execution-protocol.md 逐步执行,参考 resources/examples.md,提交前运行 resources/checklist.md;通过 oh-my-ag agent:spawn 启动时会自动注入执行协议。检查清单覆盖无障碍、移动端、性能、错误边界与加载骨架、Vitest 测试、类型检查与 Lint。

限制:components/ui/* 视为只读,自定义需创建包装组件;不得硬编码颜色与字符串,设计令牌与 i18n 分别以 packages/design-tokens(OKLCH)和 packages/i18n 为准;导入必须使用绝对路径 @/,接口与类型必须用 import type;自定义逻辑须有超过 90% 单元测试覆盖;骨架屏须放在指定 skeleton 目录。具体定价、平台支持范围与更多收费信息暂未提供。