Passer au contenu principal

​
Modèles de pull request

Devin peut utiliser des modèles de pull request de style GitHub. Il recherche dans votre dépôt le premier fichier de modèle correspondant et l’utilise lors de la génération ou de la régénération d’une description de pull request. En plus des noms de fichiers standard de GitHub, Devin prend également en charge une variante spécifique à Devin, ce qui vous permet de fournir à Devin un modèle différent de celui utilisé par vos auteurs humains.

​
1. Ordre de découverte

La première correspondance l’emporte (de haut en bas) : 
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE.md
pull_request_template.md
docs/PULL_REQUEST_TEMPLATE.md
docs/pull_request_template.md
.github/PULL_REQUEST_TEMPLATE.md
.github/pull_request_template.md
Les entrées DEVIN_PR_TEMPLATE.md et devin_pr_template.md sont des substitutions facultatives spécifiques à Devin (les variantes en majuscules et en minuscules sont prises en charge). Si aucune n’existe, les emplacements standard PULL_REQUEST_TEMPLATE.md et pull_request_template.md sont utilisés. Si rien ne correspond, Devin revient à sa structure par défaut intégrée.

​
2. Modèle Devin personnalisé (optionnel)

Ajoutez un modèle réservé à Devin en créant l’un des suivants : 
.github/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
.github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
docs/PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
docs/PULL_REQUEST_TEMPLATE/devin_pr_template.md
PULL_REQUEST_TEMPLATE/DEVIN_PR_TEMPLATE.md
PULL_REQUEST_TEMPLATE/devin_pr_template.md
Utilisez ceci si vous voulez que Devin ajoute une structure supplémentaire (par ex. des indications pour la checklist des risques) sans changer ce que les utilisateurs voient dans leur PULL_REQUEST_TEMPLATE.md ou pull_request_template.md habituel. Les variantes en majuscules et en minuscules sont toutes deux prises en charge. Si vous préférez un modèle unique et partagé, conservez simplement (ou ajoutez) : 
.github/pull_request_template.md
Les espaces réservés et les commentaires HTML seront supprimés automatiquement.

​
3. Modèle par défaut intégré (si aucun fichier n’est trouvé)

Si aucun fichier de modèle n’existe, Devin utilise un modèle par défaut interne comportant les sections suivantes :
  • Summary
  • Review & Testing Checklist
  • (Optional) Mermaid diagram
  • Notes
Vous n’avez pas besoin de le recopier, sauf si vous souhaitez le personnaliser ; fournir l’un des fichiers pris en charge ci‑dessus remplace entièrement le modèle par défaut.

​
4. Référence GitHub

Devin suit les règles de résolution des modèles monofichier de GitHub. Pour en savoir plus sur les modèles de pull request GitHub (y compris les workflows avec plusieurs modèles), consultez la documentation GitHub.
Configuration minimale pour donner à Devin son propre modèle : 
mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [titre]\n\n## Résumé\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
Et voilà : ouvrez ou recréez la PR et Devin l’utilisera.