core-principles

此技能作为 React 19 单页应用生态系统中架构原则与开发标准的权威来源。专为软件工程师与自动化代理设计，通过强制执行一致的项目结构、严谨的数据获取模式与现代化工具实践，确保代码库的高质量。通过为功能开发维护明确的规范，能有效防止架构偏移，并简化团队使用 Vite、TypeScript、Biome 与 TanStack 生态系统时的入门流程。

• 标准化项目组织，区分应用外壳、路由逻辑、纯 UI 组件与领域专属的功能钩子 (hooks)。

• 定义严格的代理执行规则，包含使用 Apidog MCP 进行强制性的 API 规格同步，以及通过 TanStack Query 进行的优化数据访问模式。

• 推广 React 19 的编译器友好开发实践，包含自动记忆化 (auto-memoization)、纯组件设计与现代化的服务器变动 (mutation) 策略。

• 通过全面的测试需求确保质量，强调 React Testing Library、Vitest 以及使用 MSW 进行网络模拟。

• 提供明确的「完成」检查清单，以标准化拉取请求 (Pull Request) 的准备工作与提交前的代码质量。

• 在初始化新功能或模块时使用此技能，以符合预先定义的文件夹结构与服务分层要求。

• 参考权威来源章节，获取关于 React 19、Vite、Biome 与 TanStack 整合模式的相关文档。

• 务必调用 Apidog MCP 整合，作为 API 类型生成的主要来源，以维持后端规格与前端客户端之间的类型安全性。

• 仅在编译器限制明确要求时使用「use no memo」指令，并优先考虑标准的 React 19 自动记忆化功能。

• 确保所有新路由皆在 TanStack Router 的文件导向系统内实现，并纳入预取加载器 (prefetch loaders) 以优化导航性能。