Tecnologia além do código.
Régys Borges da Silveira

Sua primeira skill: transforme uma tarefa repetitiva em um procedimento

Mesa ilustrativa com pedido de revisão, procedimento e relatório, representando uma skill
Neste artigo 9 tópicos

Você pede à IA para revisar uma alteração. Na primeira vez, lembra de explicar o objetivo, indicar os arquivos e exigir evidências. Na segunda, esquece de avisar que a revisão não pode modificar o código. Na terceira, recebe uma resposta organizada, mas sem saber se os testes mencionados realmente foram executados. Falta um procedimento que possa ser reutilizado sem depender da memória de cada conversa.

Uma skill pode organizar esse trabalho. Vamos construir uma pequena skill de revisão de uma rotina de importação em Delphi, partindo do pedido concreto e chegando às instruções de execução. O cenário é fictício. O objetivo é aprender a estruturar o procedimento, não anunciar que um arquivo de texto garante uma revisão correta. Também veremos como conferir seus limites antes de utilizá-lo.

Se a dificuldade começa porque ninguém definiu o comportamento esperado, vale conhecer SDD em Delphi. A apresentação do livro relaciona especificações, contratos e critérios de aceitação ao desenvolvimento. A página oferece uma degustação para avaliar se esse aprofundamento corresponde à necessidade do seu projeto, antes de comprar a obra.

Comece pela tarefa, não pelo arquivo

Skill, neste contexto, significa um conjunto reutilizável de instruções para uma tarefa delimitada. Não é um novo modelo de IA, um treinamento dos seus parâmetros nem uma função compilada. Pense nela como um procedimento entregue ao agente, o sistema que combina o modelo com acesso a ferramentas e documentos. O agente ainda precisa interpretar a situação, e sua resposta precisa ser conferida.

O primeiro passo é escolher algo reconhecível. “Ajudar no desenvolvimento” é amplo demais para orientar uma primeira experiência. “Revisar uma alteração na prévia de importação de produtos” permite identificar entrada, resultado e limites. Prévia é a etapa em que os dados são apresentados e validados antes da gravação definitiva; essa separação será importante no exemplo.

Uma tarefa que muda completamente a cada solicitação pode continuar na conversa. Também não vale criar uma skill apenas para armazenar informações que deveriam estar na documentação. A conveniência aparece quando existe uma maneira de trabalhar que se repete, enquanto os arquivos e detalhes examinados mudam. A skill conserva o método; o pedido atual define o trabalho concreto.

Essa distinção se conecta ao artigo sobre instruções de projeto e skills. Uma orientação geral pode informar a versão de Delphi utilizada. A skill explica como examinar uma mudança. Nenhum dos documentos substitui a solicitação que identifica qual alteração será revisada agora.

Defina o resultado e o que fica de fora

No cenário fictício, a importação recebe registros com um campo chamado CodigoProduto. A regra é rejeitar código vazio ou formado apenas por espaços na prévia. O relatório precisa apontar se a mudança respeita essa regra, indicar onde encontrou evidência e registrar o que não conseguiu conferir. Não queremos uma declaração genérica de que o código parece bom.

Critério de aceitação é uma condição observável para decidir se o resultado atende ao esperado. Aqui, uma entrada com espaços não deve ser tratada como produto válido. Isso é diferente de pedir “faça uma boa validação”, expressão que deixa indefinido o comportamento. Antes de organizar o procedimento da IA, precisamos saber o que estamos procurando no software.

O limite deve ser explícito. A tarefa é revisar, não corrigir, gravar dados ou reorganizar a aplicação. Se surgir um defeito, a entrega será uma descrição com evidência e impacto. A implementação depende de outro pedido. Esse cuidado evita transformar uma revisão autorizada em uma alteração que o usuário não solicitou.

Estabeleça as entradas mínimas: alteração a examinar, regra aplicável e arquivos relevantes. Não é necessário exigir um formulário extenso. Se a regra estiver ausente, o agente pode perguntar o que falta ou apresentar a limitação. Inventar o requisito para conseguir terminar produziria um relatório mais confiante, mas menos útil.

O que existe dentro de SKILL.md

A documentação oficial de criação de skills descreve uma pasta com um arquivo SKILL.md e recursos opcionais. O arquivo contém name e description, seguidos das instruções. ChatGPT e Codex começam pelos metadados de descoberta e carregam as instruções completas quando selecionam a skill. Isso pertence ao comportamento documentado dos produtos, não a qualquer ferramenta de IA.

Metadados são informações que descrevem o próprio recurso. No início do arquivo, aparecem em YAML, formato que representa dados com pares de chave e valor. O trecho delimitado por três hífens é chamado de front matter. Nesse exemplo, o nome identifica a skill e a descrição explica quando considerá-la. O restante utiliza Markdown para organizar as orientações.

Nossa descrição precisa ser mais específica que “revisar código”. Deve permitir reconhecer a revisão da prévia e evitar atrair pedidos de implementação. A escolha das palavras define como apresentamos a capacidade antes das instruções detalhadas. Isso não transforma a descrição em mecanismo de segurança, mas torna sua intenção mais clara.

Começaremos sem scripts ou referências adicionais. Um procedimento pequeno pode ser autocontido. Acrescentar pastas vazias para reproduzir uma estrutura sofisticada só aumentaria a manutenção. Recursos extras fazem sentido quando existe conteúdo ou execução que merece ser separado, assunto de outro capítulo da série. Aqui, queremos um arquivo que o leitor consiga compreender integralmente.

Um exemplo completo e pequeno

O arquivo a seguir é um exemplo didático de SKILL.md. Ele não foi instalado em um agente de produção. As regras de importação são convenções fictícias do exercício, não requisitos universais de Delphi ou dos sistemas empresariais.

---
name: revisar-previa-importacao
description: Revisar alterações na prévia de importação de produtos em Delphi, com foco em códigos vazios e evidências. Não usar para implementar correções ou executar importações reais.
---

## Objetivo

Produza uma revisão da alteração solicitada, sem modificar arquivos ou dados.

## Entradas

Identifique a alteração, os arquivos relevantes e a regra de validação.
Se faltar uma entrada necessária, explique a limitação ou peça esclarecimento.

## Procedimento

1. Leia a alteração e a regra aplicável antes de concluir.
2. Examine CodigoProduto vazio ou composto apenas por espaços.
3. Confira se a prévia continua separada da gravação definitiva.
4. Examine os testes disponíveis e registre quais foram executados.
5. Relate achados com arquivo, localização, impacto e evidência.

## Limites

Não implemente correções nem execute importações reais.
Não acesse dados de clientes para construir exemplos.
Não trate uma sugestão de teste como teste executado.

## Entrega

Apresente achados, verificações realizadas e limitações.
Se não encontrar problemas, delimite o que foi examinado.
Não declare a aplicação inteira aprovada por uma revisão parcial.

O procedimento preserva uma sequência útil: compreender a regra, examinar a alteração, conferir a separação das etapas e registrar evidências. Não tenta ensinar toda a linguagem Object Pascal. A informação que muda a decisão do revisor é o foco da análise e a fronteira entre examinar e alterar. Isso mantém o arquivo proporcional à tarefa.

O resultado não depende de um relatório de muitas páginas. Um achado curto pode ser suficiente se indicar o trecho problemático, explicar a consequência e mostrar a base da conclusão. Uma resposta extensa sem localização ou evidência não atende ao objetivo. Consistência não deve ser confundida com quantidade de texto.

Da solicitação ao relatório

Quatro etapas: identificar o pedido, obter código e regra, buscar evidências e relatar achados e limitações, sem autorização para corrigir ou gravar dados

Infográfico ilustrativo gerado por IA. Síntese autoral do procedimento proposto neste artigo, não resultado de uma execução.

Imagine o pedido: “Revise a mudança que passou a validar CodigoProduto na prévia. Considere a regra de rejeitar vazio e espaços. Não altere arquivos.” O pedido identifica a tarefa atual; a skill fornece o método. Se a alteração não estiver acessível, o agente precisa registrar isso ou solicitar o material, não descrever um código que não leu.

Ao encontrar uma condição que compara apenas com a string vazia, o revisor deve verificar como o restante do fluxo trata espaços antes de apontar um defeito. Uma comparação isolada não prova que a aplicação aceita o registro: pode haver tratamento anterior ou posterior. É preciso buscar contexto suficiente para sustentar a conclusão, sem inventar o comportamento da rotina.

Se houver testes, o relatório distingue leitura e execução. “Existe um teste para espaços” é uma observação sobre o material consultado. “Executei o teste e ele passou” exige registro de execução no ambiente. Se o compilador estiver indisponível, a limitação aparece na entrega. Uma skill útil não elimina obstáculos; orienta como lidar com eles de maneira transparente.

Essa preocupação complementa o uso de IA em um projeto Delphi existente. O procedimento organiza uma revisão pequena, mas não permite concluir que toda a aplicação foi validada. Dependências, configuração e integração continuam exigindo verificações proporcionais ao alcance da mudança.

Confira o arquivo e depois o comportamento

A primeira conferência é estrutural: existem os metadados necessários, instruções compreensíveis e uma entrega coerente? Isso pode detectar nome inadequado, seção esquecida ou exemplo incompleto. Não comprova que a ferramenta descobrirá a skill nem que o agente cumprirá as orientações. A instalação e a seleção dependem do ambiente utilizado; copiar o arquivo para uma pasta qualquer não demonstra acionamento.

O exemplo é ilustrativo. Sua leitura não demonstra seleção automática, execução por um agente ou aprovação do código Delphi. Para testar comportamento, seria necessário fornecer uma alteração conhecida em um ambiente isolado, observar quais arquivos foram examinados e comparar a entrega com critérios definidos antes do ensaio. Essa diferença evita chamar revisão de texto de teste completo.

Um conjunto inicial de casos pode incluir a revisão pedida, uma solicitação para corrigir a mesma rotina e uma pergunta sem relação com importação. A revisão é o uso pretendido; os outros pedidos ajudam a avaliar o limite da descrição. Uma alteração com defeito conhecido permite conferir se o relatório o identifica sem concluir sobre trechos não examinados.

No artigo sobre testes gerados por IA e os limites do que eles provam, a questão também é evidência. Uma execução bem-sucedida informa algo sobre aquele cenário. Não autoriza afirmar que a skill funciona em toda situação. Amplie os casos conforme riscos e falhas observados, não apenas para acumular exemplos favoráveis.

Quando simplificar e quando parar

Uma primeira skill não precisa executar tudo sozinha. Se a tarefa exige acesso à produção, obtenção de dados pessoais ou ampliação de escopo, pare no limite e solicite direção. Instruções não concedem credenciais nem substituem controles de acesso. A proteção precisa existir também nas ferramentas e no ambiente em que o agente atua.

Vale abandonar a skill quando ela não compensa. Se o procedimento muda a cada uso, uma conversa contextualizada talvez seja mais simples. Se a verificação é mecânica, um teste automatizado pode oferecer resposta mais direta. A escolha é entre formas de trabalho que produzem evidência adequada com manutenção razoável, não uma obrigação de utilizar IA em toda etapa.

Evite corrigir qualquer falha acrescentando mais um parágrafo universal. Primeiro descubra se houve falta de material, descrição inadequada, ambiente indisponível ou instrução ambígua. A correção deve responder à causa observada. Uma biblioteca fica mais compreensível quando cada arquivo tem um trabalho próprio e não tenta resolver todos os problemas do projeto.

Conclusão

Criar a primeira skill começa pela definição da tarefa, não por copiar uma árvore de diretórios. No exemplo de importação, foi preciso estabelecer o que revisar, quais entradas utilizar, como sustentar um achado e onde parar. O SKILL.md reúne esse procedimento, mas não transforma instruções em permissões nem substitui a verificação dos resultados.

Escolha uma tarefa pequena que você conhece e explicite seu método. Depois, confira o arquivo e teste o comportamento em situações controladas, mantendo evidências das limitações. Para aprofundar o resultado esperado, SDD em Delphi oferece uma ponte para especificações e critérios de aceitação. A skill organiza o trabalho; critérios claros permitem avaliar se ele foi bem feito.

Referências

OPENAI. Build skills. ChatGPT Learn, [s. d.]. Disponível em: https://learn.chatgpt.com/docs/build-skills. Acesso em: 4 out. 2026.

SILVEIRA, Régys Borges da. AGENTS.md, instruções e skills: como orientar uma IA dentro do projeto. regys.com.br, 2026. Disponível em: https://regys.com.br/agents-md-instrucoes-e-skills-como-orientar-uma-ia-dentro-do-projeto/. Acesso em: 4 out. 2026. Rascunho agendado consultado no acervo editorial.

SILVEIRA, Régys Borges da. Como gerar testes com IA e descobrir quando eles não provam nada. regys.com.br, 2026. Disponível em: https://regys.com.br/como-gerar-testes-com-ia-e-descobrir-quando-eles-nao-provam-nada/. Acesso em: 4 out. 2026. Rascunho agendado consultado no acervo editorial.

SILVEIRA, Régys Borges da. Como usar IA em um projeto Delphi existente sem perder o controle. regys.com.br, 2026. Disponível em: https://regys.com.br/como-usar-ia-em-um-projeto-delphi-existente-sem-perder-o-controle/. Acesso em: 4 out. 2026. Rascunho agendado consultado no acervo editorial.

SILVEIRA, Régys Borges da. SDD em Delphi. Livros de Régys Borges da Silveira, [s. d.]. Disponível em: https://livros.regys.com.br/sdd-em-delphi. Acesso em: 4 out. 2026.

Compartilhar por e-mail

0 comentário(s)

Participe da conversa

Seu e-mail não será publicado.

Este site utiliza o Akismet para reduzir spam. Saiba como seus dados em comentários são processados.

Um próximo passo para cada interesse.

Continue estudando com os livros, acompanhe as videoaulas ou consulte as soluções para o seu projeto.

Descubra mais sobre Régys Borges da Silveira

Assine agora mesmo para continuar lendo e ter acesso ao arquivo completo.

Continuar lendo