planejador-de-atualizacao-de-dependencias

Constrói um plano seguro e ordenado para atualizar dependências de projetos, agrupando mudanças que quebram compatibilidade e sinalizando riscos antes de qualquer alteração. Use quando o usuário pedir para atualizar dependências, atualizar pacotes, pular uma versão principal, resolver pacotes desatualizados ou vulneráveis, ou planejar uma migração de framework. Não use para escrever funcionalidades de aplicação ou corrigir bugs de aplicação.

O que é planejador-de-atualizacao-de-dependencias?

Este skill, Planejador de Atualização de Dependências, ajuda um agente de IA a gerar um plano seguro e ordenado de atualização de dependências para projetos de software, sem fazer alterações reais até que o usuário aprove. Ele detecta o ecossistema de pacotes (npm, pip, Go, Rust, Ruby, Maven), lê versões atuais do manifesto e arquivo de bloqueio (lockfile), e usa ferramentas nativas como `npm outdated`, `pip list --outdated`, `go list -u -m all`, `cargo outdated` e `bundle outdated` para listar versões disponíveis. Em seguida, classifica cada pacote desatualizado como patch/menor (seguro), principal (que requer revisão de changelog) ou de segurança (prioridade). O plano organiza as atualizações em lotes: primeiro correções de segurança, depois patches/menores, principais independentes e, por fim, principais que precisam ser movidas juntas. O skill também exige que se forneça comandos de verificação exatos e instruções de rollback por lote, e que nunca se modifique o manifesto durante o planejamento. O output segue um template de markdown detalhado. O skill suporta os principais ecossistemas de pacotes e é compatível com ferramentas de linha de comando comuns (CLI) e agentes de IA como Claude Code, Cursor e Codex.

Funciona com~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 Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Planejador de Atualização de Dependências

Produza um plano. Não atualize nada até que o usuário aprove o plano.

Procedimento

  1. Detecte o ecossistema a partir do manifesto: package.json, requirements.txt ou pyproject.toml, go.mod, Cargo.toml, Gemfile, pom.xml. Se vários existirem, pergunte qual planejar, ou planeje-os separadamente.
  2. Leia as versões atuais do manifesto e do arquivo de bloqueio (package-lock.json, poetry.lock, go.sum, Cargo.lock, Gemfile.lock).
  3. Encontre versões disponíveis com a ferramenta do próprio ecossistema e relate a saída que você realmente obteve:
    • npm: npm outdated
    • Python: pip list --outdated ou uv pip list --outdated
    • Go: go list -u -m all
    • Rust: cargo outdated
    • Ruby: bundle outdated Se a ferramenta não estiver disponível, diga isso e trabalhe a partir do manifesto, marcando versões como não verificadas.
  4. Classifique cada pacote desatualizado:
    • Patch / menor — geralmente seguro.
    • Principal — leia o changelog ou as notas de versão para mudanças que quebram compatibilidade antes de planejá-lo.
    • Segurança — qualquer coisa sinalizada por npm audit, pip-audit, govulncheck, cargo audit ou bundle audit. Esses vão primeiro.
  5. Ordene o trabalho em lotes:
    • Lote 0: correções de segurança, mesmo que sejam principais.
    • Lote 1: patches e aumentos menores, agrupados por área.
    • Lote 2: principais sem dependência cruzada, um por commit.
    • Lote 3: principais que devem se mover juntos (por exemplo, um framework e seus plugins).
  6. Para cada lote, informe: os pacotes, as versões de/pra, as mudanças que quebram compatibilidade que se aplicam, o código ou configuração que deve mudar e como verificar.

Template de saída

## Plano de atualização

Ecossistema: <npm / pip / go / cargo / ...>
Manifesto: <caminho>

### Lote 0 — Segurança
| Pacote | De | Para | Motivo | Quebra? |
| --- | --- | --- | --- | --- |

### Lote 1 — Patch e menor
...

### Lote 2 — Principal, independente
...

### Lote 3 — Principal, deve mover junto
...

### Verificação

Após cada lote: <o comando exato que prova que nada regrediu>

### Reversão

Por lote: <como reverter, por ex., git revert do commit do lote>

### Adiado

<Pacotes intencionalmente deixados de lado e por quê>

Regras

  • Nunca edite o manifesto durante o planejamento. Produza o plano e então pare.
  • Leia o changelog real para um aumento principal quando um estiver disponível; não presuma que uma versão quebra compatibilidade só porque o número principal mudou.
  • Sempre nomeie o comando de verificação. "Execute os testes" não é um comando; npm test é.
  • Explique o motivo do adiamento quando você deixar um pacote de fora — por exemplo, uma versão principal cujas notas de versão você não pôde ler.
  • Não execute comandos de instalação, atualização ou auditoria que modifiquem a árvore. npm outdated, npm audit e seus equivalentes são somente leitura e estão ok.

Arquivo de suporte

references/upgrade-strategy.md explica o agrupamento em lotes, casos extremos de semver e como lidar com um pacote que deve ser retido.

Individual skills in this repo

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

Habilidades Relacionadas