Tecnologia além do código.
Régys Borges da Silveira
Início / Acervo

Tag: skills

7 resultado(s)

Ilustração realista de relatório examinado ao lado de critérios e registros de execução

Como testar uma skill e descobrir se ela realmente melhorou o trabalho

Uma nova versão da skill entrega um relatório mais bonito. Os subtítulos estão organizados, o tom parece seguro e a conclusão é direta.

Ver resumo completo

Uma nova versão da skill entrega um relatório mais bonito. Os subtítulos estão organizados, o tom parece seguro e a conclusão é direta. Isso pode ser uma melhoria editorial, mas ainda não responde se o agente examinou o código certo, detectou um defeito ou respeitou o limite de não modificar arquivos. A aparência do resultado não substitui uma avaliação do trabalho.

Neste capítulo, vamos construir essa avaliação. Retomaremos a revisão fictícia da prévia de importação em Delphi, definiremos critérios antes da execução e veremos como comparar mudanças sem esconder falhas. Uma demonstração local mostrará o limite de um verificador estrutural: ele pode aceitar um relatório que afirma ter executado testes sem apresentar evidência.

O ponto de partida é definir o resultado esperado. A apresentação de SDD em Delphi relaciona especificações, contratos e critérios de aceitação ao desenvolvimento. A página oferece uma degustação para avaliar esse aprofundamento. Na avaliação de uma skill, a mesma preocupação evita decidir depois da resposta quais critérios seriam convenientes para considerá-la boa.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração realista de cartões de tarefas examinados diante de uma pasta de procedimento, representando a seleção de uma skill

Por que sua skill não é acionada ou aparece na tarefa errada

Você organizou um procedimento, escreveu o arquivo e esperou que a IA o utilizasse. Mas ela respondeu como se a skill não existisse.

Ver resumo completo

Você organizou um procedimento, escreveu o arquivo e esperou que a IA o utilizasse. Mas ela respondeu como se a skill não existisse. Em outra conversa, o problema foi inverso: uma skill de revisão apareceu em uma tarefa que pedia implementação. Antes de aumentar as instruções ou culpar o modelo, precisamos descobrir em qual etapa o comportamento se afastou do esperado.

Este capítulo da série sobre instruções para IA trata do acionamento: a passagem entre existir uma capacidade disponível e ela ser escolhida para uma solicitação. Vamos distinguir disponibilidade, seleção e execução, revisar descrições e construir casos de contraste. Usaremos o mesmo exemplo fictício de revisão da prévia de importação em Delphi, sem apresentar essas sugestões como um experimento de eficácia já realizado.

O problema também depende de contexto e limites de atuação. A apresentação de IA Além da Conversa aborda essa passagem da resposta isolada para sistemas com ferramentas, permissões e avaliação. A página oferece uma degustação para conhecer o conteúdo antes de decidir pela compra. Aqui, vamos aplicar essas preocupações a uma dúvida específica: por que o procedimento certo não entra no trabalho certo?

Publicado em · Régys Borges da Silveira
Ler artigo →
Mesa ilustrativa com procedimento central e materiais de apoio organizados em compartimentos separados

Como organizar skills com referências, modelos e scripts

Uma skill começa pequena: objetivo, entradas, passos e entrega. Depois chegam novas regras, exemplos, modelos de relatório e comandos.

Ver resumo completo

Uma skill começa pequena: objetivo, entradas, passos e entrega. Depois chegam novas regras, exemplos, modelos de relatório e comandos. Em pouco tempo, o arquivo principal parece um manual inteiro. Separar tudo em pastas pode aliviar a leitura, mas também cria outro problema: o procedimento passa a depender de documentos que ninguém sabe quando consultar.

Este capítulo trata dessa distribuição. Vamos distinguir instruções, referências, modelos e scripts, usando a revisão fictícia da prévia de importação em Delphi que acompanha a série. A proposta não é montar a maior estrutura possível. É organizar cada recurso conforme seu papel e manter visíveis as decisões essenciais, inclusive quando algum material estiver ausente.

Essa organização exige entender o trabalho antes de automatizá-lo. Em SDD em Delphi, a apresentação relaciona especificações, contratos e critérios de aceitação à construção de software. A página oferece uma degustação para avaliar o aprofundamento. A ligação com este artigo é concreta: um procedimento só pode buscar evidência útil quando sabe qual comportamento deve examinar.

Publicado em · Régys Borges da Silveira
Ler artigo →
Mesa ilustrativa com pedido de revisão, procedimento e relatório, representando uma skill

Sua primeira skill: transforme uma tarefa repetitiva em um procedimento

Você pede à IA para revisar uma alteração. Na primeira vez, lembra de explicar o objetivo, indicar os arquivos e exigir evidências.

Ver resumo completo

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.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração de duas folhas: texto corrido e conteúdo organizado em títulos e listas.

Como escrever um arquivo Markdown que humanos e IA consigam usar

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente.

Ver resumo completo

Você tem as informações necessárias para orientar uma revisão, mas elas estão num parágrafo que mistura objetivo, regras, exceções e resultado esperado. Quem lê precisa reconstruir essa organização mentalmente. Quando o documento cresce, surgem referências vagas, instruções repetidas e dúvidas sobre o que realmente deve ser feito. Trocar a extensão do arquivo não resolve essa dificuldade.

Markdown ajuda a organizar texto sem exigir um editor sofisticado. Ele permite indicar títulos, listas, links e trechos de código usando caracteres comuns. Mas a qualidade do arquivo depende também de decisões de escrita: explicar o contexto, separar responsabilidades e oferecer critérios que permitam conferir o trabalho. Formatação e entendimento precisam caminhar juntos.

Neste segundo capítulo da série sobre instruções para IA, vamos aprender a sintaxe essencial e aplicá-la ao exemplo fictício de revisão de uma importação Delphi. O objetivo não é decorar todos os recursos do formato, mas construir um documento que uma pessoa consiga revisar e uma ferramenta consiga apresentar de forma previsível. Também veremos os limites desse cuidado.

Para aprofundar a passagem de uma solicitação vaga para requisitos, contratos e critérios de aceite, conheça SDD em Delphi. O sumário e a degustação gratuita ajudam a avaliar esse método antes de escolher a edição. A conexão com este capítulo é direta: um arquivo bem apresentado só ganha valor técnico quando registra um entendimento verificável.

Publicado em · Régys Borges da Silveira
Ler artigo →
Ilustração realista de uma mesa com pedido avulso, regras de projeto, manual de referência e procedimento de revisão.

Prompt, instrução, referência ou skill: onde colocar cada informação para a IA

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco.

Ver resumo completo

Você pede à inteligência artificial que revise uma rotina de importação. Acrescenta as regras de negócio, explica como executar os testes, cola uma página de documentação e lembra que ela não deve gravar no banco. Na revisão seguinte, monta quase a mesma mensagem. Depois de algumas semanas, existem versões diferentes dessas orientações, e ninguém sabe qual delas continua válida.

O problema não começa na falta de um arquivo especial. Começa quando informações com funções diferentes são tratadas como se fossem uma única mensagem. Um pedido descreve o trabalho de agora; uma regra orienta o projeto; um documento fornece evidência; um procedimento organiza uma tarefa repetível. Separar essas funções ajuda tanto o leitor humano quanto o assistente que recebe o contexto.

Este artigo abre a série sobre instruções para IA, do Markdown às skills. Vamos construir essas distinções usando uma manutenção Delphi fictícia, mostrar onde cada informação pode ficar e propor um exercício de organização. Não é preciso conhecer agentes ou formatos de arquivos para acompanhar. Os exemplos são propostas didáticas, não resultados medidos de uma integração.

Quando a dificuldade é transformar uma intenção em regras e critérios verificáveis, SDD em Delphi oferece um aprofundamento em especificações, contratos e rastreabilidade. Consulte o sumário e a degustação gratuita para avaliar esse percurso. Para estudar as camadas de contexto, ferramentas e operação ao redor do modelo, a leitura complementar é IA Além da Conversa.

Publicado em · Régys Borges da Silveira
Ler artigo →
Capa oficial do livro ACBr com IA na Prática ao lado dos conceitos contexto, ação e evidência.

ACBr com IA na Prática para desenvolver em Delphi com mais critério

Quem mantém um sistema comercial em Delphi conhece a distância entre receber uma sugestão e entregar uma alteração confiável. Uma configuração precisa corresponder ao ambiente instalado, um documento deve representar os dados corretos e uma correção precisa sobreviver à compilação, aos testes e à operação.

Ver resumo completo

Quem mantém um sistema comercial em Delphi conhece a distância entre receber uma sugestão e entregar uma alteração confiável. Uma configuração precisa corresponder ao ambiente instalado, um documento deve representar os dados corretos e uma correção precisa sobreviver à compilação, aos testes e à operação. A inteligência artificial pode ajudar nesse percurso, mas uma resposta convincente ainda não demonstra que o trabalho foi resolvido.

É com essa preocupação que apresento meu novo livro, ACBr com IA na Prática: Inteligência artificial aplicada ao dia a dia do desenvolvimento com Delphi e ACBr. A proposta é aproximar a IA dos problemas concretos de desenvolvimento, diagnóstico e manutenção, sem transferir a ela a responsabilidade por decisões técnicas ou fiscais. O centro da leitura é um método de trabalho que o desenvolvedor consegue acompanhar, conferir e repetir.

Neste artigo, explico o recorte da obra, o que o leitor encontra nos materiais e como começar a aplicar essa abordagem em uma tarefa pequena. Não é preciso dominar inteligência artificial para entender a proposta. É importante, porém, reconhecer que produtividade não deve ser medida apenas pela quantidade de código produzido ou pela velocidade da primeira resposta.

Conheça o livro ACBr com IA na Prática, consulte o sumário e leia a degustação na página oficial.

Publicado em · Régys Borges da Silveira
Ler artigo →