react-query

SKILL.md

Comprehensive guide for TanStack Query based on TkDodo's authoritative blog posts. TkDodo (Dominik Dorfmeister) is a core maintainer of TanStack Query. Contains patterns across 17 categories covering queries, mutations, caching, TypeScript, testing, and advanced patterns.

| Priority | Category | Impact | Key Concept |

| 1 | Mental Model | CRITICAL | React Query is an async state manager, not a fetching library | | 2 | Query Keys | CRITICAL | Keys are dependencies - include all variables that affect data | | 3 | Status Handling | HIGH | Check data first, then error, then loading | | 4 | Mutations | HIGH | Invalidation vs direct cache updates, optimistic patterns |

來自 TkDodo 權威指南的 TanStack 查詢（React Query）最佳實踐和模式。在編寫、審查或調試 React Query 代碼（包括查詢、突變、緩存、樂觀更新和 TypeScript 集成）時使用。在 useQuery、useMutation、useInfiniteQuery、QueryClient、queryKey、staleTime、cacheTime、gcTime、invalidateQueries 或 React Query 模式上觸發。 來源：umxr/react-query-skills。

查看原文