database-migration

Visão Geral

O que é database-migration?

database-migration é uma skill de desenvolvimento backend criada para ajudar equipes a gerenciar migrações de esquema e dados em bancos de dados usando ORMs populares, incluindo Sequelize, TypeORM e Prisma. Ela oferece estratégias para deploys sem downtime, procedimentos robustos de rollback e transformações de dados, sendo ideal para projetos que exigem mudanças confiáveis no banco sem interrupção do serviço.

Para quem esta skill é indicada?

Esta skill é recomendada para desenvolvedores backend, engenheiros de banco de dados e profissionais de DevOps que precisam:

• Migrar entre diferentes ORMs
• Realizar transformações de esquema
• Transferir dados entre bancos
• Implementar procedimentos de rollback
• Aplicar mudanças no banco com zero downtime
• Atualizar versões de banco de dados
• Refatorar modelos de dados

Problemas resolvidos

• Alterações de esquema seguras e confiáveis
• Fluxos de trabalho automatizados para migrações
• Suporte a rollback para migrações com falha
• Compatibilidade com múltiplos ORMs

Como Usar

Passos para instalação

Para instalar database-migration, execute:

npx skills add https://github.com/wshobson/agents --skill database-migration

Primeiros passos

1. Revise o arquivo SKILL.md para uma visão geral dos fluxos de migração e ORMs suportados.
2. Explore README.md, AGENTS.md e metadata.json para instruções detalhadas e contexto.
3. Verifique as pastas rules/, resources/, references/ e scripts/ para auxiliares e exemplos de migração.
4. Adapte as estratégias de migração para o repositório, ORM e requisitos de deploy do seu projeto.

Exemplos de migração suportados por ORM

Sequelize

• Crie arquivos de migração em migrations/.
• Use npx sequelize-cli db:migrate para aplicar migrações.
• Use npx sequelize-cli db:migrate:undo para rollback.

TypeORM

• Crie classes de migração em migrations/.
• Execute migrações com comandos CLI do TypeORM.
• Faça rollback usando os recursos de undo do TypeORM.

Prisma

• Utilize as ferramentas de migração do Prisma para alterações de esquema e rollback.

Melhores práticas

• Teste migrações em ambiente de staging antes da produção.
• Use controle de versão para scripts de migração.
• Implemente procedimentos de rollback para mudanças críticas.

Perguntas Frequentes

Onde encontro exemplos de migração?

Consulte o arquivo SKILL.md e a pasta migrations/ para scripts de migração de exemplo para Sequelize, TypeORM e Prisma.

database-migration suporta deploys sem downtime?

Sim, a skill oferece orientações e estratégias para migrações de banco de dados sem downtime, minimizando interrupções durante alterações no esquema.

Posso usar database-migration para transformações de dados?

Com certeza. A skill é projetada para migrações tanto de esquema quanto de dados, incluindo fluxos complexos de transformação.

Como faço rollback de uma migração?

Cada ORM suportado inclui comandos e procedimentos para rollback. Consulte os exemplos de migração e a documentação para detalhes.

database-migration é adequada para projetos frontend?

Não, esta skill é focada em engenharia de banco de dados backend e não é indicada para migrações de frontend ou UI.

Onde posso ver todos os arquivos e scripts?

Abra a aba Files para visualizar a árvore completa de arquivos, incluindo referências aninhadas e scripts auxiliares.