jsonapi

Skill do ścisłej kontroli zgodności API z specyfikacją JSON:API v1.1. Automatycznie aktywuje się podczas tworzenia lub modyfikacji endpointów API, przeglądania odpowiedzi oraz walidacji poprawności struktury. Zapewnia, że Twoje API przestrzega obowiązkowych reguł specyfikacji: prawidłowa struktura dokumentu, użycie nagłówka Content-Type, obsługa błędów i relacji między zasobami. Współpracuje z innymi narzędziami — łącz z django-drf do pełnej implementacji.

1. Zainstaluj skill jsonapi w swoim projekcie — będzie dostępny w katalogu umiejętności agenta.
2. Podczas tworzenia lub modyfikacji endpointów API skill automatycznie się aktywuje; możesz też ręcznie go wywołać, gdy przeglądzasz istniejące odpowiedzi API.
3. Zanim zaczniesz implementować lub przeglądać endpoint, upewnij się, że masz dostęp do najnowszej specyfikacji JSON:API — jeśli dostępne jest Context7 MCP, użyj go do zapytania o szczegółowe reguły dotyczące struktury dokumentu, relacji lub obsługi błędów.
4. Jeśli Context7 nie jest dostępne, skill może pobrać specyfikację bezpośrednio ze strony https://jsonapi.org/format/ w celu weryfikacji najnowszych wymagań.
5. Skill sprawdzi krytyczne reguły: czy odpowiedź zawiera data lub errors (nigdy oba jednocześnie), czy typ zasobu i identyfikator są prawidłowe, czy nagłówek Content-Type to application/vnd.api+json, oraz czy struktura całego dokumentu jest zgodna ze specyfikacją.
6. Jeśli pracujesz nad implementacją w Django REST Framework, łącz ten skill z umiejętnością django-drf — jsonapi waliduje wymagania specyfikacji, a django-drf podpowiada wzorce kodu.