1.01 projeto
Skills para o Genie Code
o agente de IA para engenharia de dados da Databricks
● em curso · catorze skills em uso
O agente de código acerta a lógica, mas erra onde salvar, como nomear e o que registrar. Dá para corrigir isso com instrução escrita? E como é que se prova que corrigiu?
o problema
De onde elas vieram
As skills da plataforma ensinam o agente a usar o Databricks. Não dizem que estratégia de gravação usar, que nome dar a uma tabela ou em que pasta um arquivo novo nasce. Sem nada escrito, o agente decide por conta própria.
- na conversa
Eu corrigia o agente, e a correção só valia até o fim daquela sessão.
- na sessão seguinte
O mesmo erro voltava, porque nada tinha ficado escrito em lugar nenhum.
- no projeto da CVM
Cada erro repetido virou uma instrução escrita para aquele pipeline.
- em agosto
As instruções serviam a qualquer projeto e ganharam repositório próprio.
o que é
O que é uma skill
Uma skill é um arquivo de texto com uma regra dentro. O cabeçalho traz a description, que diz em que situações a regra vale e em quais não vale. O corpo diz o que fazer quando a situação aparece. Um arquivo cuida de um assunto só.
--- name: naming-conventions description: Use ao definir, nomear, escolher, estabelecer ou criar nomes para assets NOVOS -- notebooks, tabelas, DataFrames, variaveis, pastas. Convencoes de numeracao (001_, 103_), principio DRY, padroes de caixa (snake_case, PascalCase). NAO use para revisar ou validar nomenclatura de codigo existente. --- # Nomenclatura e Convenções ## Princípios Gerais ## Notebooks ## DataFrames ## Princípio DRY ## Pastas
como escolhe
Como o agente escolhe
Antes de responder, o Genie Code compara a tarefa com a description de cada skill disponível e carrega só as que combinam, sem que ninguém indique qual usar. Escolha uma tarefa abaixo e veja quais entram e quais ficam de fora.
as catorze
As catorze juntas
Quase toda description termina dizendo o que a skill não faz e para qual outra o caso deve ir. Cada citação dessas vira uma linha no desenho abaixo. Entre as catorze skills, são trinta linhas, e só duas ficam soltas.
catorze skills
trinta fronteiras declaradas
As duas soltas são a git-workflow e a skill-patterns: não citam nenhuma outra, e nenhuma outra cita as duas.
clique num nó para ler · clique de novo para soltar
o que sobreviveu
O que sobreviveu aos testes
No começo as skills não eram acionadas. Formulei três hipóteses sobre o que o acionamento exigia e testei uma de cada vez. Nenhuma se confirmou como exigência técnica, mas duas deixaram uma prática que vale até hoje.
a avaliação
Como se prova
Nada do que está acima diz se as skills mudam o resultado do trabalho. O agente podia já fazer tudo aquilo sozinho, e eu não tinha como saber sem medir. A medida é o mesmo trabalho feito duas vezes, trocando uma única coisa.
braço 1
as treze skills em avaliação, ativas
braço 2
as mesmas treze skills, desligadas
estado
Onde isso está hoje
As catorze estão num repositório público, com cada mudança registrada em commit desde que saíram do projeto da CVM. Lá dá para ler cada regra por inteiro, e não só o pedaço que aparece nesta página como exemplo.
skill-patterns fica fora porque trata de escrever skills, e não de engenharia de dados