Alembic skill

O que ela faz

A skill ensina o Claude a usar o Alembic, a ferramenta de migração de banco do SQLAlchemy, com exemplos em PostgreSQL. Cobre instalação, alembic init, conexão pela variável DATABASE_URL e migração criada à mão ou gerada a partir dos modelos, sempre revisada antes de rodar.

Traz receitas pra mexer nos dados junto com a estrutura, processar tabela grande em lotes, subir e voltar versões, ver o histórico e juntar ramos de migração de vários desenvolvedores. Também mostra como testar migração com pytest e rodar tudo no GitHub Actions.

Pra produção, tem checklist antes do deploy, script que faz backup antes de migrar e a técnica de mudar sem derrubar o sistema em quatro passos: criar a coluna opcional, preencher aos poucos, tornar obrigatória e remover a antiga. Os exemplos usam um sistema de atendimento com tickets.

Nas palavras de quem fez

Quando usar

• Adicionar uma coluna ou tabela num banco que já tem dados de clientes
• Converter ou renomear um campo sem perder o que está gravado
• Montar o deploy da migração com backup e caminho de volta
• Resolver conflito quando duas pessoas criaram migração ao mesmo tempo
• Consertar um banco que ficou fora de sincronia com o histórico de migrações

Depois de instalar, é só pedir assim

• Configura o Alembic neste projeto e faz ele ler a conexão do DATABASE_URL
• Cria uma migração que adiciona prioridade nos tickets sem tirar o sistema do ar
• Minha migração falhou no meio, me ajuda a voltar o banco pra última versão boa

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykPassou

Perguntas