Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

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.

Repozytorium
claude-packs ↗
Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

86/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść21 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.