API Versioning

Referenční vzory pro verzování, zastarávání a migraci REST API bez narušení klientů.

od wpank · wpank/ai

Otestováno · Funguje ★ 9.2/10

API Versioning — Referenční vzory pro verzování, zastarávání a migraci REST API bez narušení klientů.

Co umí

Dovednost čistě založená na znalostech, pokrývající strategie verzování API (URL path, header, query param, content negotiation), klasifikaci breaking-change, časové osy zastarávání a migrační vzory (adapter/facade). Spouští se při vývoji API, plánování breaking-change nebo správě životních cyklů verzí/zastarávání.

Testovací report

Aplikováno na skutečný scénář breaking-change (přejmenování pole, změna autentizace), vygenerovalo přesnou specifikaci RFC 8594 Sunset-header, 410-Gone JSON tělo a konkrétní minimální 12měsíční dobu zastarávání veřejného API — generická základní verze pouze naznačovala 'komunikujte změnu' bez ničeho z toho.

Testováno: 2026-07-16 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

/api-versioningReferenční vzory pro verzování, zastarávání a migraci REST API bez narušení klientů.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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?

Kompletní testovací report (anglicky) →