change-an-api
/change-an-api
Pomaga zmienić to, co trasa API przyjmuje lub zwraca, także przy usuwaniu lub zmianie nazw pól, bez psucia działania klientów.
- Autor
- TheDecipherist ↗
- Repozytorium
- claude-packs ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 11.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Pomaga zmienić to, co trasa API przyjmuje lub zwraca, także przy usuwaniu lub zmianie nazw pól, bez psucia działania klientów.
Oryginalny opis (EN)
Use when changing what a route accepts or returns, when removing or renaming a field, or when a client needs something a published version does not give.
Jak działa
SKILL.md bez nagłówków drugiego poziomu · 17 linii, 161 słów
Podgląd SKILL.md
--- name: change-an-api description: Use when changing what a route accepts or returns, when removing or renaming a field, or when a client needs something a published version does not give. --- # Change an API (one job: no client that works today breaks) <constraints> Always do: 1. Decide if the change is additive: a new optional field, a new route, a new optional parameter. Additive goes in the current version. 2. Treat these as breaking: a field removed, renamed or changed in type; a new required input; tighter validation; another status code; another default. 3. For a breaking change, add `/api/v<N+1>/` beside the old version. Freeze the old schema, and copy nothing you can share through a handler. 4. Mark the old version with `Deprecation` and `Sunset` headers, and say when it goes in the changelog. 5. Update the contract test for the new version only. A failing old-version test means the change broke it. 6. Move the clients you own, then watch the old version's traffic before removing it. Never do: - Edit an old version's contract test to make it pass. - Remove a version that still has traffic. </constraints>
Wersje
W bazie nie ma innych skilli o nazwie change-an-api.
Migawka bazy z 13.11.2026 · wersja paczki b6fb809926f5 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100translations
Pomaga przy usuwaniu lub zmianie kodu z useTranslations() i getTranslations() oraz przy dodawaniu, usuwaniu i zmianie kluczy w apps/web/messages/en.json i innych plikach lokalizacji. - 90refactoring-shared-component-api
Pomaga zmienić publiczne API współdzielonego komponentu UI, na przykład nazwę propsa lub kontrakt zdarzeń, bez psucia konsumentów. - 100api-contract-versioning
Pomaga przy zmianach endpointu, schematu lub kontraktu API używanego gdzie indziej: zmiany pól, paginacji, wersjonowanie, zmiany łamiące i deprecjacja pól lub tras w REST, GraphQL i gRPC. - 90api-versioning
Prowadzi zmiany API widoczne dla klientów, jak zmiana nazwy lub usunięcie pola, zgodnie wstecznie albo przez jawną wersję ze ścieżką deprecjacji. - 100field-rename-verification
Zapobiega niepełnej analizie zależności przy zmianie nazw pól i kontraktów API w wielu usługach, śledząc ścieżki odczytu, zapisu i przekazywania. - 100api-design
Pomaga przy zmianie kontraktu API: nowego endpointu, sposobu zwracania błędów i stron, pól do dodania lub usunięcia oraz wersji.