用途：为 React 应用提供使用 React Query 进行数据获取、缓存与服务端状态同步的规范指南。
主要能力：核心原则要求所有数据获取与缓存使用 React Query，服务端数据用其内置状态管理而非 useState，客户端全局状态用 React Context 与 useReducer，通过合理缓存避免过多 API 调用，并始终处理加载与错误状态。主题按关注点分为：客户端设置与文件布局、读取数据、写入数据、服务端与客户端状态、缓存速度与重渲染、失败处理与恢复。
使用方式：参考文件按需加载（渐进式披露），仅在任务需要时读取对应文件。setup.md 用于项目脚手架与 QueryClient/QueryClientProvider 一次性配置（staleTime、cacheTime、retry、DevTools）；queries.md 用于查询钩子，含类型化查询、服务端抛出的友好错误、依赖查询、分页查询与 useInfiniteQuery；mutations.md 用于变更钩子，含缓存失效与乐观更新回调模式；state-management.md 用于服务端与客户端状态划分及与 Context/Reducer 或 Zustand 集成；performance.md 用于查询键工厂、select 选择性订阅与预取；error-handling.md 用于全局 onError 默认值与错误边界重试。
约定与限制：使用 DevTools 检查缓存；按功能目录组织钩子；错误需友好提示并可重试；只取所需数据；避免深层嵌套查询；组件局部数据用本地状态，共享数据用全局状态。反模式包括：不用 useEffect 获取数据、不把服务端数据存入 useState、不忽略加载与错误处理、不创建无缓存失效策略的查询、条件查询不跳过 enabled、不忽略查询响应的 TypeScript 类型。具体安装命令与代码示例暂未提供。