API Versioning

Wzorce referencyjne do wersjonowania, wycofywania i migracji interfejsów API REST bez łamania klientów.

Autor: wpank · wpank/ai

Testowano · Działa ★ 9.2/10

API Versioning — Wzorce referencyjne do wersjonowania, wycofywania i migracji interfejsów API REST bez łamania klientów.

Co robi ten skill

Czysto wiedza umiejętność obejmująca strategie wersjonowania API (ścieżka URL, nagłówek, parametr zapytania, negocjacja treści), klasyfikację zmian powodujących łamanie kompatybilności, harmonogramy wycofywania i wzorce migracji (adapter/fasada). Wyzwalana przy ewolucji API, planowaniu zmian powodujących łamanie kompatybilności lub zarządzaniu cyklami życia wersji/wycofywania.

Raport z testu

Zastosowana do rzeczywistego scenariusza powodującego łamanie kompatybilności (zmiana nazwy pola, zmiana uwierzytelniania) wygenerowała dokładną specyfikację nagłówka RFC 8594 Sunset, ciało JSON 410-Gone i konkretne minimum 12-miesięcznego publicznego wycofywania API – ogólny punkt wyjścia jedynie zasygnalizował „komunikuj zmianę” bez żadnego z tego.

Testowano: 2026-07-16 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/wpank/ai
mkdir -p ~/.claude/skills
cp -r ai/skills/api/api-versioning ~/.claude/skills/api-versioning

Komendy i przykładowe prompty

/api-versioningWzorce referencyjne do wersjonowania, wycofywania i migracji interfejsów API REST bez łamania klientów.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

How should I version this REST API before renaming a response field?
Write a deprecation timeline for sunsetting our old API auth method
What's the best way to roll out a breaking API change without upset?

Pełny raport →