Toolverse
Wszystkie skille

linear-performance-tuning

autor: jeremylongshore

Zoptymalizuj zapytania do Linear API i zmniejsz liczbę żądań dzięki cache'owaniu

Instalacja

Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.

Instalacja

Szybkie info

Wyświetlenia
1

O skillu

Skill do optymalizacji wydajności Linear API poprzez eliminację zapytań N+1, implementację cache'owania i batching mutacji. Użyj go, gdy chcesz przyspieszyć odpowiedzi, zmniejszyć liczbę wywołań API lub wdrożyć strategie cache'owania dla danych Linear. Skill obsługuje trzy główne mechanizmy: spłaszczanie zapytań GraphQL, cache'owanie danych statycznych z unieważnianiem przez webhooki oraz łączenie mutacji w pojedyncze żądania.

Jak używać

  1. Upewnij się, że masz zainstalowaną bibliotekę @linear/sdk i skonfigurowany klucz API Linear w zmiennej środowiskowej LINEAR_API_KEY.

  2. Wyzwól skill frazami takimi jak "linear performance", "optimize linear", "linear caching", "linear slow queries", "speed up linear" lub "linear N+1", aby aktywować optymalizację.

  3. Zidentyfikuj problemy N+1 w kodzie — zwróć uwagę na pętle, które dostępują właściwości relacyjne (np. .assignee, .state) na wielu obiektach. Każdy dostęp generuje osobne żądanie API.

  4. Zastosuj spłaszczanie zapytań, używając rawRequest z precyzyjnym wyborem pól zamiast leniwego ładowania relacji. Pozwoli to na pobranie wszystkich potrzebnych danych w jednym żądaniu GraphQL.

  5. Dla danych statycznych (stany, użytkownicy, zespoły) wdroż cache'owanie z unieważnianiem opartym na webhookach Linear, aby uniknąć powtarzających się zapytań.

  6. Łącz wiele mutacji w jedno żądanie GraphQL, aby zmniejszyć liczbę żądań i przyspieszić operacje zapisu. Pamiętaj o budżecie złożoności zapytań (250 000 punktów na godzinę, maksymalnie 10 000 na zapytanie).

Podobne skille