SuperAPI AI 工具集

core-principles

前端与建站

查看项目

更新于 10-16 06:24

技能介绍

用途:该技能用于规划新项目、新人上手或评审架构决策时,提供 React 19 单页应用(SPA)开发的核心理念与项目结构规范。

主要能力与结构:技术栈涵盖 React 19(含 React Compiler 自动记忆化)、严格模式 TypeScript、Vite、Biome(格式化与检查)、TanStack Query(服务端状态)、TanStack Router(基于文件的路由)、Vitest(jsdom 测试)以及 Apidog MCP(作为 API 规格的唯一来源)。项目目录约定为 /src 下的 app、routes、components、features、api、lib、test 等。核心原则包括:每个文件单一职责;UI 组件不发起服务端数据请求;查询与变更放在 feature hooks 中;测试与文件同目录。

使用方式:新增或修改代码时,需通过 Apidog MCP 获取最新 API 规格并在变更时重新生成 /src/api 类型;数据访问只通过封装 TanStack Query 的 feature hooks,禁止在 UI 组件内请求;新路由在 /src/routes 下创建文件,导航需要数据时用 loader 预取;服务端变更使用 React 19 Actions 或 TanStack Query 的 useMutation(每个特性二选一),配合 useOptimistic 或 Query 乐观更新,成功后使缓存失效或选择性更新;保持代码纯净以适配编译器;新增逻辑需有 Vitest 测试,组件测试用 RTL,网络用 msw 打桩;提交前运行 biome check --write 并确保 Vite 构建通过。

适用场景:React 19 SPA 项目初始化、代码评审、架构与目录规范对齐。

限制:资料未提供价格、平台支持范围与性能指标;相关技能包括 tooling-setup、react-patterns、tanstack-router、tanstack-query、router-query-integration、api-integration、performance-security。