Saltar al contenido principal

Plantillas de Pull Request

Devin puede usar plantillas de pull request al estilo GitHub. Busca en tu repositorio el primer archivo de plantilla que coincida y lo utiliza al generar o volver a generar la descripción de un PR. Además de los nombres de archivo estándar de GitHub, Devin también admite una variante específica para Devin, de modo que puedas darle una plantilla diferente de la que usan tus colaboradores humanos.

1. Orden de detección

Se aplica la primera coincidencia (de arriba hacia abajo):
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
Las entradas con DEVIN_PR_TEMPLATE.md y devin_pr_template.md son reemplazos opcionales específicos de Devin (se admiten ambas variantes, en mayúsculas y en minúsculas). Si no existe ninguna, se usan las ubicaciones estándar PULL_REQUEST_TEMPLATE.md y pull_request_template.md. Si no hay ninguna coincidencia, Devin recurre a su estructura predeterminada integrada.

2. Plantilla personalizada de Devin (opcional)

Añade una plantilla exclusiva para Devin creando una de las siguientes:
.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
Utiliza esto si quieres que Devin añada estructura adicional (por ejemplo, sugerencias para una checklist de riesgos) sin cambiar lo que los usuarios ven en su PULL_REQUEST_TEMPLATE.md o pull_request_template.md habitual. Se admiten tanto las variantes en mayúsculas como en minúsculas. Si prefieres una única plantilla compartida, simplemente conserva (o agrega):
.github/pull_request_template.md
Los marcadores de posición y los comentarios HTML se limpiarán automáticamente.

3. Valor predeterminado integrado (si no se encuentra ningún archivo)

Si no existe ningún archivo de plantilla, Devin utiliza un valor predeterminado interno con secciones para:
  • Resumen
  • Lista de verificación de revisión y pruebas
  • (Opcional) diagrama Mermaid
  • Notas
No es necesario que copies esto a menos que quieras personalizarlo; proporcionar cualquiera de los archivos compatibles anteriores reemplaza por completo el valor predeterminado.

4. Referencia de GitHub

Devin sigue las reglas de resolución de plantillas de GitHub para un solo archivo. Para obtener más información sobre las plantillas de pull request (PR) de GitHub (incluidos flujos de trabajo con múltiples plantillas), consulta este enlace.
Configuración mínima para asignarle a Devin su propia plantilla:
mkdir -p .github/PULL_REQUEST_TEMPLATE
echo "# [título]\n\n## Resumen\n...\n" > .github/PULL_REQUEST_TEMPLATE/devin_pr_template.md
Eso es todo: abre o vuelve a generar el PR y Devin lo usará.