SuperAPI AI 工具集

frontend-dev-guidelines

前端与建站

查看项目

更新于 10-16 00:00

技能介绍

用途:这是一套面向生产级 React + TypeScript 应用的前端开发规范,定义代码“必须怎么写”,而非“可以怎么写”。适用于创建组件或页面、新增特性、数据获取与变更、路由搭建、MUI 样式、性能问题处理以及代码评审与重构。

主要能力:提供前端可行性与复杂度指数(FFCI),从架构契合度、复杂度、性能风险、可复用性、维护成本五个维度打分,公式为 FFCI =(架构契合度 + 可复用性 + 性能)−(复杂度 + 维护成本),范围 -5 到 +15,10–15 可推进、6–9 谨慎推进、3–5 简化或拆分、≤2 重新设计。核心架构原则包括:Suspense 为默认,使用 useSuspenseQuery,禁止 isLoading 条件与提前返回的加载态;对路由、特性入口组件、数据表格、图表、编辑器、大型对话框等重内容懒加载;按特性组织代码,领域逻辑放 features/,可复用基础组件放 components/,禁止跨特性耦合;TypeScript 严格模式,禁止 any,显式返回类型,统一使用 import type。

使用方式:提供新组件与新特性检查清单、必需的导入别名(@/ 指向 src/,~types、~components、~features 等)、组件结构顺序(类型/Props、Hooks、派生值、处理器、渲染、默认导出)、懒加载模式、数据获取规范、TanStack Router 的基于文件夹路由与懒加载、MUI v7 样式规范(小于 100 行内联 sx,超过则独立 styles 文件,Grid 使用 size 属性)、加载与错误处理(仅用 useMuiSnackbar)、性能默认值(useMemo、useCallback、React.memo、300–500ms 防抖、清理副作用)、TypeScript 标准、规范文件结构与组件模板,以及反模式清单。

适用场景与限制:面向具有长期维护周期的生产 React 代码库,风格明确且可强制执行。资料未提供安装命令、依赖版本细节、收费信息或具体平台支持范围;部分集成技能(如 frontend-design、page-cro、analytics-tracking、backend-dev-guidelines、error-tracking)仅列出名称,未展开说明。