API Versioning
Modèles de référence pour la versioning, la dépréciation et la migration des API REST sans casser les clients.
Testé · Fonctionne
Ce que fait
Une compétence purement informative couvrant les stratégies de versioning d'API (chemin d'URL, en-tête, paramètre de requête, négociation de contenu), la classification des changements cassants, les calendriers de dépréciation et les modèles de migration (adaptateur/façade). Se déclenche lors de l'évolution d'une API, de la planification d'un changement cassant ou de la gestion des cycles de vie de version/dépréciation.
Rapport de test
Appliqué à un scénario réel de changement cassant (renommer un champ, changer l'authentification), il a produit une spécification exacte d'en-tête RFC 8594 Sunset, un corps JSON 410-Gone, et un minimum concret de 12 mois de dépréciation d'API publique — une base générique n'a fait qu'effleurer 'communiquer le changement' sans rien de tout cela.
Testé le: 2026-07-16 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/wpank/ai mkdir -p ~/.claude/skills cp -r ai/skills/api/api-versioning ~/.claude/skills/api-versioning
Commandes et exemples de prompts
/api-versioningModèles de référence pour la versioning, la dépréciation et la migration des API REST sans casser les clients.
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
How should I version this REST API before renaming a response field?Write a deprecation timeline for sunsetting our old API auth methodWhat's the best way to roll out a breaking API change without upset?