de agent-skills-standard488
Directives de conception d'API REST d'opinion : sémantique HTTP, codes d'état, conception d'URL, versionnage, pagination et meilleures pratiques de contrats OpenAPI.
Cette compétence codifie les conventions et les meilleures pratiques des API REST : utilisation correcte des verbes HTTP, codes d'état, nommage des URL, stratégie de versionnage, enveloppes de pagination, génération OpenAPI et en-têtes de sécurité de base. Elle guide les ingénieurs et les agents pour concevoir des API cohérentes, découvrables et versionnables.
À utiliser lors de la conception d'API, de l'écriture de contrôleurs/routes, de la création de spécifications OpenAPI, de la révision de PR pour les changements majeurs, ou de la mise en œuvre de politiques de pagination/versionnage. Elle se déclenche lorsque vous modifiez des contrôleurs, des routes ou des fichiers de contrat d'API.
Utile pour les agents assistants développeurs (bots de revue de code, linters de PR, générateurs de documentation) et tout agent aidant au code backend (conventions de routage nestjs, express, spring, nextjs).
Compétence de pure documentation fournissant des directives de conception d'API REST basées sur des opinions, couvrant les verbes HTTP, les codes de statut, la conception d'URL, le versionnage, la pagination et les contrats OpenAPI. Aucun script intégré. Bien structuré avec des exemples et des anti-modèles clairs. Largement applicable à tout développeur backend.
Aucun problème de sécurité — pas de scripts, pas de commandes shell, pas d'appels réseau. Compétence de documentation pure et propre. Le lien de référence pointe vers references/REFERENCE.md mais le contenu n'a pas été récupéré (non intégré dans les scripts).
