用途：该技能是 TanStack Query v5 应用的性能优化指南，包含 8 个类别共 40 条规则，按影响程度排序，用于指导自动化重构与代码生成。适用时机：编写新的查询、变更或数据抓取逻辑；实现缓存策略（staleTime、gcTime）；审查性能问题或请求瀑布；重构既有代码；实现无限查询、Suspense 或乐观更新时。
规则类别与优先级：1）查询键结构（CRITICAL，前缀 tquery-），包括集中式键工厂、层级键、始终使用数组键、键使用可序列化对象、queryOptions 模式、键与功能就近放置。2）缓存配置（CRITICAL，cache-），理解 staleTime 与 gcTime、配置全局默认值、placeholderData 与 initialData 的正确使用、精准失效、控制自动重取触发、使用 enabled 做条件查询。3）变更模式（HIGH，mutation-），带回滚的乐观更新、在 onSettled 而非 onSuccess 中失效、乐观更新前取消查询、用 setQueryData 立即更新缓存、避免对同一数据并行变更。4）预取与瀑布（HIGH，prefetch-），避免请求瀑布、悬停预取、在 queryFn 中预取依赖数据、在服务端组件中预取、扁平化 API。5）无限查询（MEDIUM，infinite-），用 maxPages 限制页数、扁平化页面用于渲染、理解重取行为、正确处理加载状态。6）Suspense 集成（MEDIUM，suspense-），使用 Suspense 钩子、始终搭配错误边界、用 useSuspenseQueries 组合、合理放置边界。7）错误与重试（MEDIUM，error-），指数退避重试、按错误类型条件重试、全局错误处理、错误展示模式、配合错误边界使用 throwOnError。8）渲染优化（LOW-MEDIUM，render-），记忆化 select、用 select 派生数据、notifyOnChangeProps 限制重渲染、理解结构共享、避免解构全部属性。
使用方式：按前缀查阅 references/{prefix}-{slug}.md 参考文件，每个文件含原因说明、错误代码示例与正确代码示例。完整规则见 AGENTS.md。相关技能：类型安全查询钩子见 orval，测试中模拟 API 见 test-msw，React 19 数据抓取见 react-19。限制：资料未提供安装命令、收费或价格信息。