
de agent-skills-standard509
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 documentation pure fournissant des directives de conception d'API REST basées sur une opinion, couvrant les verbes HTTP, les codes de statut, la conception d'URL, le versionnage, la pagination et les contrats OpenAPI. Aucun script inclus. Bien structurée avec des exemples clairs et des anti-modèles. 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 inclus dans les scripts).
Normes Communes de Conception d'API
Conventions de conception d'API REST d'opinion : verbes HTTP, codes d'état, modèles d'URL, versionnage, pagination et exigences OpenAPI pour des API fiables et versionnées.
React Native Navigation (v6)
Directives et modèles pour configurer React Navigation v6 : piles typées, onglets, deep linking, flux d'authentification et anti-modèles pour les applications React Native.
Bonnes Pratiques PHP
Normes de codage PHP et conseils d'architecture (PSR-12, SOLID, nommage, structure) pour améliorer la qualité, la maintenabilité et la testabilité du code.
Laravel Eloquent : Requêtes Sûres et Performantes
Directives pragmatiques pour écrire des requêtes Eloquent performantes et sûres dans Laravel : eager loading, scopes réutilisables, prévention du lazy-loading strict et gestion sécurisée de la mémoire.
Gestion d'état Flutter BLoC
Directives et liste de vérification pour l'implémentation d'une gestion d'état BLoC/Cubit prévisible et testable dans les applications Flutter, avec les modèles recommandés et les anti-patterns.
Normes de Documentation (Priorité à l'Intention)
Directives et modèles pour des commentaires de code, README, ADR et documentations API axés sur l'intention, afin de produire une documentation technique claire et maintenable.