SuperAPI AI 工具集

frontend-best-practices

前端与建站

查看项目

更新于 10-16 02:35

技能介绍

用途:为构建正确、可访问、快速且类型安全的前端 UI 提供工程规范,原则与框架无关,适用于 React、SolidJS 等。

主要能力:涵盖九个主题——组件架构与组合、状态与数据流、异步与数据获取、表单与校验、无障碍、性能与渲染、TypeScript 纪律、测试原则、项目结构与工具。强调区分服务端状态与本地状态、异步的 loading/error/empty/success 四态、用 Zod 单一 schema 推导类型、语义化 HTML 优先、先测量再优化、开启 strict 与 noUncheckedIndexedAccess、按功能组织目录、Vite + pnpm + ESLint + Prettier 基线工具。

使用方式:先检测框架,顺序为显式声明、package.json 依赖、tsconfig 的 jsxImportSource、文件扩展名与导入。React 加载 references/react.md,SolidJS 加载 references/solidjs.md,只加载匹配的一个。可用 grep -E '"(react|react-dom|next|solid-js|@solidjs/[^"]+|solid-start)"' package.json 与 grep -E '"jsxImportSource"' tsconfig*.json 快速检查。Vue、Svelte 暂无参考,仅用共享原则。若信号冲突或无信号,询问用户一次。

适用场景:编写或重构前端代码、按九个主题审查 diff。

限制:不重新教授测试运行器,TDD 交给 tdd 技能,端到端与浏览器测试交给 playwright 技能;服务端模板 hx-* 场景应改用 htmx-go-templates 技能。审查时只指出实际问题并说明原因。