Auto-actualizar descripción y etiquetas de PR

Resumen

Un comando que actualiza automáticamente las descripciones y etiquetas de Pull Request. Analiza los cambios de Git para generar y establecer descripciones y etiquetas apropiadas.

Uso

bash
/pr-auto-update [opciones] [número de PR]

Opciones

• --pr <número>: Especificar número de PR objetivo (se detecta automáticamente desde la rama actual si se omite)
• --description-only: Actualizar solo la descripción (mantener etiquetas sin cambios)
• --labels-only: Actualizar solo etiquetas (mantener descripción sin cambios)
• --dry-run: Mostrar contenido generado sin realizar actualizaciones reales
• --lang <idioma>: Especificar idioma (es, en)

Ejemplos Básicos

bash
# Auto-actualizar PR para rama actual
/pr-auto-update

# Actualizar PR específico
/pr-auto-update --pr 1234

# Actualizar solo descripción
/pr-auto-update --description-only

# Verificar con dry-run
/pr-auto-update --dry-run

Detalles de Características

1. Auto Detección de PR

Detecta automáticamente el PR correspondiente desde la rama actual:

• Busca PR abierto relacionado con la rama actual
• Obtiene información del PR usando GitHub CLI
• Soporta tanto GitHub.com como GitHub Enterprise

2. Generación de Descripción

Genera automáticamente descripción del PR analizando:

• Análisis de Commits: Resumen de mensajes de commit
• Detección de Cambios: Cambios principales en archivos
• Extracción de Propósito: Identificación del objetivo del cambio
• Referencias de Issues: Detección automática de #123 mentions

3. Sugerencia de Etiquetas

Sugiere etiquetas apropiadas basadas en:

• Tipo de Cambio: enhancement, bug, documentation
• Área de Impacto: frontend, backend, database
• Prioridad: high priority, low priority
• Estado: work in progress, ready for review

4. Análisis de Impacto

Analiza el impacto de los cambios:

• Archivos Modificados: Lista de archivos y estadísticas
• Dependencias: Cambios en package.json, Gemfile, etc.
• Breaking Changes: Detección de cambios incompatibles
• Cobertura de Tests: Verificación de tests agregados

Formato de Descripción Generada

Estructura Estándar

markdown
## 📋 Resumen

[Descripción breve del propósito del PR]

## 🎯 Objetivo

- [Problema que resuelve]
- [Beneficio que aporta]

## 📝 Cambios Realizados

- [Cambio principal 1]
- [Cambio principal 2]
- [Cambio principal 3]

## 🧪 Testing

- [ ] Tests unitarios agregados/actualizados
- [ ] Tests de integración pasando
- [ ] Probado manualmente

## 📊 Impacto

- **Archivos modificados**: X archivos
- **Líneas agregadas**: +XXX
- **Líneas eliminadas**: -XXX

## 📌 Issues Relacionados

- Resuelve #123
- Relacionado con #456

## 📸 Capturas de Pantalla

[Si aplica, capturas de UI/resultado]

## ⚠️ Notas para Revisores

[Puntos específicos que necesitan atención]

Personalización por Tipo

Para Features:

• Enfoque en funcionalidad nueva
• Documentación de uso
• Ejemplos de implementación

Para Bugfixes:

• Descripción del bug original
• Causa raíz identificada
• Solución implementada

Para Refactoring:

• Justificación del cambio
• Mejoras de rendimiento/mantenibilidad
• Compatibilidad hacia atrás

Integración con CI/CD

GitHub Actions

yaml
name: Auto Update PR
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  update-pr:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Update PR Description
        run: |
          /pr-auto-update --pr ${{ github.event.pull_request.number }}

Pre-commit Hook

bash
#!/bin/bash
# .git/hooks/pre-push
if [ -n "$(git status --porcelain)" ]; then
  echo "Actualizando PR antes de push..."
  /pr-auto-update --dry-run
fi

Configuración

Archivo .pr-auto-update.yml

yaml
# Configuración personalizada
language: es # Idioma por defecto
labels:
  enabled: true
  custom:
    - "needs-review"
    - "urgent"
description:
  template: "custom" # usar template personalizado
  include_stats: true
  include_screenshots: false

Variables de Entorno

bash
export PR_AUTO_UPDATE_LANG=es
export PR_AUTO_UPDATE_TEMPLATE=detailed
export GITHUB_TOKEN=ghp_xxxxx

Solución de Problemas

Error: "No se encontró PR asociado"

bash
# Verificar rama actual
git branch --show-current

# Listar PRs abiertos
gh pr list

# Crear PR si no existe
gh pr create

Error: "Permisos insuficientes"

bash
# Verificar autenticación
gh auth status

# Re-autenticar si necesario
gh auth login

Descripción no se actualiza

bash
# Forzar actualización
/pr-auto-update --pr 1234 --force

# Verificar cambios locales
git status
git diff main...HEAD

Patrones Comunes

Proyecto Flutter

markdown
Implementado {nombre_funcionalidad} para resolver {problema_usuario}.

- **Implementación UI**: Creada nueva pantalla {nombre_pantalla}
- **Gestión de Estado**: Agregados providers de Riverpod
- **Integración API**: Implementadas queries y mutaciones GraphQL
- **Tests**: Agregados tests de widgets y tests unitarios

- **Arquitectura**: {patrón_utilizado}
- **Dependencias**: {paquetes_agregados}
- **Rendimiento**: {optimizaciones_realizadas}

Proyecto Node.js

markdown
Implementado endpoint {nombre_API} para {caso_uso}.

- **Implementación API**: Creado nuevo endpoint {ruta_endpoint}
- **Validación**: Agregada lógica de validación de requests
- **Base de Datos**: Implementadas operaciones en tabla {nombre_tabla}
- **Tests**: Agregados tests de integración y unitarios

- **Autenticación**: Validación de tokens JWT
- **Autorización**: Control de acceso basado en roles
- **Validación de Entrada**: Protección contra inyección SQL

Mejora CI/CD

markdown
Mejorado workflow de GitHub Actions para {efecto_logrado}.

- **Rendimiento**: Reducido tiempo de build en {tiempo}
- **Confiabilidad**: Reforzado manejo de errores
- **Seguridad**: Mejorada gestión de secretos

- **Paralelización**: Ejecución paralela de {nombre_jobs}
- **Caché**: Optimizada estrategia de caché para {objetivo_cache}
- **Monitoreo**: Agregado monitoreo de {métricas}

Mejores Prácticas

1. Ejecutar antes de solicitar revisión: Asegura descripciones actualizadas
2. Usar --dry-run primero: Revisa cambios antes de aplicar
3. Mantener commits limpios: Facilita generación de descripción
4. Configurar templates: Consistencia en equipo
5. Integrar con CI: Automatización completa

Casos de Uso Avanzados

Monorepo con Múltiples Packages

bash
# Detectar cambios por package
git diff main...HEAD --name-only | grep "^packages/"
/pr-auto-update
"Genera descripción separada para cada package modificado"

PR con Múltiples Colaboradores

bash
# Incluir co-autores
git log --format="%an <%ae>" | sort -u
/pr-auto-update
"Incluye sección de colaboradores en la descripción"

Release PR

bash
# Para PRs de release
git log v1.0.0...HEAD --oneline
/pr-auto-update --labels-only
"Agrega etiquetas de release y changelog"

Limitaciones

• Requiere GitHub CLI instalado y configurado
• No modifica PRs ya mergeados
• Límite de 65,536 caracteres en descripción
• No puede cambiar título del PR (usar gh pr edit para eso)

Ver También

• /pr-create - Crear nuevo PR
• /pr-review - Generar revisión de PR
• /commit-message - Generar mensajes de commit
• gh pr - GitHub CLI para PRs