applying-pr-conventions

Applying PR Conventions

Ce skill fait partie du plugin bitwarden-delivery-tools, disponible sur le marketplace AI de Bitwarden (bitwarden/ai-plugins). Son rôle est précis et délimité : composer les quatre valeurs nécessaires à une pull request conforme aux conventions Bitwarden, sans jamais ouvrir la PR elle-même (c'est le rôle du skill creating-pull-request).

Ce que fait ce skill

À chaque invocation, le skill produit et retourne :

• Le titre au format [<TICKET>] <type>: <résumé impératif court>, en lisant le fichier de référence change-type-labels.md pour choisir le bon keyword de type. La clé de ticket est incluse uniquement si elle est connue — jamais inventée.
• Le body, construit à partir du template .github/PULL_REQUEST_TEMPLATE.md du dépôt cible, rempli avec le contenu réel du changement. Si le template est absent, un squelette par défaut est utilisé. Lorsque le skill appelant fournit des résultats de review, une section ## 🤖 AI-assisted review est ajoutée.
• Le label t: résolu, c'est-à-dire le label GitHub que le keyword de type du titre correspond dans la table de référence.
• Le choix du label ai-review, proposé à l'utilisateur parmi ai-review, ai-review-vnext ou aucun label.

Utilisation dans le cycle de livraison

Ce skill est conçu pour être appelé par d'autres skills du plugin bitwarden-delivery-tools (par exemple lors d'un workflow de livraison complet) ou directement par l'utilisateur avec des demandes comme « quel devrait être le titre de ma PR ? », « rédige le body de la PR » ou « quel label ai-review choisir ? ». Il retourne des chaînes de caractères considérées comme non fiables (template externe + texte généré) et signale explicitement à l'appelant comment les passer en toute sécurité à gh (via --body-file et un fichier temporaire pour le titre).

Limites explicites

Ce skill ne soumet pas la pull request, ne recherche pas lui-même les résultats de review, et ne gère pas le mapping type/label hors du contexte d'une PR en cours de composition. Ces responsabilités appartiennent respectivement aux skills creating-pull-request et labeling-changes.