Actualizador de GitHub Actions
Mantén actualizados los archivos .github/workflows/*.yml y .github/workflows/*.yaml escaneando las acciones, resolviendo las últimas versiones y sugiriendo mejoras.
Inicio rápido
Cuando el usuario pregunte algo como:
"Actualiza mis GitHub Actions" "¿Qué acciones están desactualizadas?" "Sube las versiones de mis workflows"
Sigue el flujo de trabajo a continuación y devuelve un informe en Markdown con sugerencias en formato diff.
Flujo de trabajo
-
Escanea los workflows
- Encuentra todos los archivos
.github/workflows/*.ymly.github/workflows/*.yaml. - Si no existe ninguno, indícaselo al usuario y detente.
- Encuentra todos los archivos
-
Extrae las referencias
uses:- Analiza cada workflow en busca de líneas
uses:. - Omite:
- Rutas locales:
./... - Referencias Docker:
docker://... - Commits SHA completos: cualquier cosa que parezca un SHA hexadecimal de 40 caracteres
- Rutas locales:
- Registra:
action,current_version,workflow_file,line_number.
- Analiza cada workflow en busca de líneas
-
Resuelve la última versión
- Divide cada acción en
owner/repo. - Prueba las herramientas en este orden:
gh api repos/{owner}/{repo}/tags --jq '.[].name'sighestá disponible.fetchenhttps://api.github.com/repos/{owner}/{repo}/tags.- Brave Search / Google Search MCP para
"{owner}/{repo} latest release tag".
- Filtra las etiquetas a semver válido.
- Por defecto, prefiere etiquetas mayores (
v5) sobre semver completo (v5.3.1). - Si no existe una etiqueta mayor, recurre a la etiqueta semver más alta.
- Divide cada acción en
-
Detecta cambios importantes
- Si la última versión es una versión mayor superior a la actual, márcala como cambio importante.
- Verifica el registro incrustado a continuación para advertencias conocidas.
-
Genera el informe de sugerencias
- Produce un informe en Markdown con:
- Tabla resumen: acción | actual | última | ¿Ruptura? | archivo
- Bloques diff por acción
- Advertencias de cambios importantes con
⚠
- No edites los archivos de workflow a menos que el usuario lo pida explícitamente.
- Produce un informe en Markdown con:
Registro de cambios importantes
- action: actions/checkout
from_major: 3
to_major: 4
warning: "El runtime Node se actualizó de 16 a 20. Verifica los runners personalizados y la configuración auto-alojada."
- action: actions/setup-node
from_major: 3
to_major: 4
warning: "El runtime Node 16 está obsoleto; ahora se usa Node 20."
- action: actions/setup-go
from_major: 4
to_major: 5
warning: "Runtime Node 20. Verifica cualquier clave de caché personalizada o efectos secundarios."
Plantilla de salida
## Informe de actualización de GitHub Actions
| Acción | Actual | Última | ¿Ruptura? | Archivo |
|--------|--------|--------|-----------|--------|
| actions/checkout | v3 | v4 | ⚠ sí | .github/workflows/ci.yml |
### Cambios sugeridos
`.github/workflows/ci.yml`:
```diff
- uses: actions/checkout@v3
+ uses: actions/checkout@v4
Advertencias de cambios importantes
- actions/checkout@v3 → v4: El runtime Node se actualizó de 16 a 20. Verifica los runners personalizados y la configuración auto-alojada.
## Reglas
- Nunca escribas archivos de workflow en silencio.
- Siempre muestra una vista previa en formato diff antes de cualquier edición.
- Si se alcanzan los límites de tasa de la API de GitHub, recurre a MCPs de búsqueda o guía manual.
- Si una acción no tiene etiquetas semver, indica "no se puede determinar la última versión".