vscode-ia/.github/skills/vitruvio-sql-script-case/SKILL.md

name, description, argument-hint

name	description	argument-hint
vitruvio-sql-script-case	Crie ou ajuste scripts Oracle PL SQL por caso no DavinTI Vitruvio. Use para gerar .sql, .pks ou .pkb com comentario de CASO, convencoes PRC_VTR ou FNC, schema explicito, tratamento de excecoes, consulta segura de metadata e preparo de DDL sem executar nada no banco.	Descreva o caso, o objeto SQL e o resultado esperado.

Script SQL por Caso

Quando usar

• Criacao ou ajuste de arquivos .sql, .pks e .pkb no padrao DavinTI e Vitruvio.
• Demandas que pedem procedure, function, package, query de apoio ou DDL versionado.
• Casos em que e necessario consultar metadata ou objetos do banco sem executar mudancas no ambiente.

Objetivo

Produzir scripts Oracle prontos para revisao e execucao manual, mantendo o historico por caso, convencoes do time e limites seguros de acesso ao banco.

Procedimento

1. Identifique se a demanda e de consulta, ajuste de logica PL SQL ou geracao de DDL.
2. Se faltar contexto de tabela, view, coluna ou schema, consulte metadata apenas com SELECT, DESCRIBE ou ferramentas equivalentes de inspecao.
3. Comece pelo template base e troque os placeholders do caso.
4. Use schemas explicitos, convencoes PRC_VTR_* e FNC_*, e mantenha formatacao consistente com o repositorio.
5. Prefira SELECT ... INTO com NVL ou CASE em vez de cursores desnecessarios.
6. Trate excecoes de forma explicita, incluindo WHEN NO_DATA_FOUND THEN quando aplicavel.
7. Se a demanda envolver DDL ou alteracao estrutural, gere apenas o arquivo; nao execute no banco.
8. Ao concluir, descreva o que precisa de execucao manual e quais validacoes foram feitas por inspecao.

Saida esperada

• Script Oracle alinhado ao caso e pronto para revisao.
• Comentario de historico no padrao do time.
• Descricao curta das premissas, da validacao feita e do que depende de execucao manual.

Recursos

• Checklist SQL
• Template base