Planificador de actualización de dependencias

Construye un plan seguro y ordenado para actualizar las dependencias del proyecto, agrupando cambios disruptivos y señalando riesgos antes de modificar nada. Úselo cuando el usuario solicite actualizar dependencias, actualizar paquetes, saltar a una versión principal, resolver paquetes obsoletos o vulnerables, o planificar una migración de framework. No lo use para escribir funcionalidades de la aplicación ni corregir errores de la aplicación.

¿Qué es Planificador de actualización de dependencias?

El Planificador de actualización de dependencias es una habilidad de agente de IA diseñada para generar un plan de actualización seguro y ordenado para las dependencias de un proyecto de software. Detecta el ecosistema de paquetes a partir del manifiesto (por ejemplo, package.json, requirements.txt, go.mod), lee las versiones actuales, consulta las versiones disponibles usando herramientas nativas del ecosistema (como npm outdated, pip list --outdated, etc.), y clasifica cada paquete obsoleto como parche/menor, mayor o de seguridad. Luego organiza las actualizaciones en lotes priorizando primero las vulnerabilidades de seguridad, luego parches y menores, luego cambios mayores independientes y finalmente cambios mayores que deben migrarse juntos. La habilidad produce un plan detallado que incluye tabla de versiones, cambios disruptivos, comandos de verificación, instrucciones de reversión y razones para diferir paquetes. Es compatible con npm, Python (pip/uv), Go, Cargo (Rust) y Bundler (Ruby). No modifica ningún archivo durante la planificación, solo genera el plan y se detiene para obtener la aprobación del usuario antes de realizar cualquier cambio.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/teejayfpi/agensi-skills/tree/add-agensi-skills/repo-maintenance-pack/skills/dependency-upgrade-planner

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Planificador de actualización de dependencias?

Genere un plan. No actualice nada hasta que el usuario apruebe el plan.

Procedimiento

  1. Detecte el ecosistema a partir del manifiesto: package.json, requirements.txt o pyproject.toml, go.mod, Cargo.toml, Gemfile, pom.xml. Si existen varios, pregunte cuál planificar, o planifíquelos por separado.
  2. Lea las versiones actuales del manifiesto y del archivo de bloqueo (package-lock.json, poetry.lock, go.sum, Cargo.lock, Gemfile.lock).
  3. Encuentre las versiones disponibles con la herramienta propia del ecosistema e informe la salida que realmente obtuvo:
    • npm: npm outdated
    • Python: pip list --outdated o uv pip list --outdated
    • Go: go list -u -m all
    • Rust: cargo outdated
    • Ruby: bundle outdated Si la herramienta no está disponible, dígalo y trabaje a partir del manifiesto, marcando las versiones como no verificadas.
  4. Clasifique cada paquete obsoleto:
    • Parche / menor — generalmente seguro.
    • Mayor — lea el registro de cambios o las notas de la versión para ver los cambios disruptivos antes de planificarlo.
    • Seguridad — cualquier cosa marcada por npm audit, pip-audit, govulncheck, cargo audit o bundle audit. Estos van primero.
  5. Ordene el trabajo en lotes:
    • Lote 0: correcciones de seguridad, incluso si son mayores.
    • Lote 1: actualizaciones de parche y menor, agrupadas por área.
    • Lote 2: versiones mayores sin dependencias cruzadas, uno por commit.
    • Lote 3: versiones mayores que deben moverse juntas (por ejemplo, un framework y sus plugins).
  6. Para cada lote, indique: los paquetes, las versiones de origen/destino, los cambios disruptivos que aplican, el código o la configuración que debe cambiar y cómo verificar.

Plantilla de salida

## Plan de actualización

Ecosistema: <npm / pip / go / cargo / ...>
Manifiesto: <ruta>

### Lote 0 — Seguridad
| Paquete | Desde | Hasta | Motivo | ¿Disruptivo? |
| --- | --- | --- | --- | --- |

### Lote 1 — Parche y menor
...

### Lote 2 — Mayor, independiente
...

### Lote 3 — Mayor, deben moverse juntos
...

### Verificación

Después de cada lote: <el comando exacto que demuestre que nada ha retrocedido>

### Reversión

Por lote: <cómo revertir, p. ej., git revert del commit del lote>

### Diferidos

<Paquetes dejados intencionalmente sin tocar, y por qué>

Reglas

  • Nunca edite el manifiesto durante la planificación. Genere el plan y luego deténgase.
  • Lea el registro de cambios real para una actualización mayor cuando esté disponible; no asuma que una versión es disruptiva solo porque el número mayor cambió.
  • Nombre siempre el comando de verificación. "Ejecute las pruebas" no es un comando; npm test sí lo es.
  • Fije el motivo del aplazamiento cuando deje un paquete fuera — por ejemplo, una versión mayor cuyas notas de la versión no pudo leer.
  • No ejecute comandos de instalación, actualización o auditoría que modifiquen el árbol. npm outdated, npm audit y sus equivalentes son de solo lectura y están bien.

Archivo de soporte

references/upgrade-strategy.md explica el agrupamiento en lotes, los casos límite de semver y cómo manejar un paquete que debe retrasarse.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados