用途:TanStack Query(原 React Query)是异步状态管理库,用于获取、缓存、同步和更新应用中的服务端状态,支持 React、Vue、Solid、Svelte 和 Angular。该技能用于研究其文档并指导相关开发。
主要能力与核心 hooks:useQuery 获取并缓存数据;useMutation 创建、更新、删除数据;useQueryClient 访问 QueryClient 做手动操作;useInfiniteQuery 无限滚动与分页;useSuspenseQuery 配合 React Suspense;useQueries 动态并行查询;useIsFetching 检查是否有查询正在获取;useMutationState 全局访问 mutation 状态。常见主题包括查询键、查询函数、并行/依赖查询、后台获取、窗口聚焦重取、禁用查询、重试、分页与无限查询、占位与初始数据、预取、mutation、乐观更新、查询失效、缓存、Suspense、过滤、SSR、测试。
使用方式:研究时应派生子代理进行文档研究,Task 工具参数为 description: "Research TanStack Query docs"、subagent_type: "generalPurpose"、readonly: true,不要指定 model,并给出目标、上下文、具体问题与输出要求。获取文档页面时必须在 URL 后追加 .md 以得到 markdown 版本,例如 https://tanstack.com/query/latest/docs/framework/react/overview.md ,此规则适用于所有 TanStack 文档链接。文档 URL 模式为 https://tanstack.com/query/latest/docs/framework/react/{path}.md 。可并行用 WebFetch 获取多个相关页面。
适用场景:在 React 等应用中实现数据获取与缓存、变更与乐观更新、缓存失效、无限滚动、SSR/Next.js、预取、Suspense 和测试时,可据此查找对应文档并给出安装、配置与代码示例。
限制:资料未提供安装命令、具体代码示例、默认缓存时长、收费与价格、平台支持范围等细节,暂未提供;实际以官方文档为准。