Nota

Como padronizar as ordens que você dá a um agente

Uma skill não é um funcionário novo. É a ficha plastificada do procedimento padrão do escritório no harness: unidades, formato, norma ou livro. Cola em quem já está trabalhando.

Ilustração de um cartão laminado luminoso sobre uma prancheta de desenho, com um cubo, um desenho e um livro de normas, uma skill que fica na mesma mesa.

Você não precisava de outro contrato; precisava da ficha

A ficha plastificada do procedimento padrão do escritório: a instrução padronizada da empresa que qualquer um aplica sem contratar outra pessoa. Cola em quem já está trabalhando. Não abre uma cabeça nova nem uma mesa nova. Isso, no harness, é uma skill (skill: habilidade ou procedimento empacotado).

Se você só tem três minutos: skill = ficha laminada do procedimento padrão que se adere a quem já trabalha; agente = engenheiro enviado a outra sala com pasta limpa. A skill não abre contexto novo.

Esta nota faz parte da série sobre o harness de IA para engenharia civil.

Primeiro a cena de obra, depois o anglicismo

Pense na laminada ao lado da impressora 3D do laboratório, ou no cartão de «como fechar o dia de topografia».

Caminho um: cada vez que alguém usa a IA, reescreve no prompt as mesmas oito regras. Na terceira já se esqueceram. O histórico as diluiu. Não havia procedimento; havia memória de curto prazo disfarçada de cultura.

Caminho dois: essas regras vivem como skill. Quem já está na mesa pode aplicá-las sem inventá-las de novo. A ficha cola. Não estreia cadeira. Não abre outra cabeça.

Essa é a imagem fixa: a ficha plastificada de como se faz aqui (às vezes chamam de SOP — procedimento padrão; não precisa memorizar a sigla). Qualquer um aplica. Cola em quem já está trabalhando. Não abre uma cabeça nova nem um contexto novo.

O que é uma skill: instrução padronizada da empresa

Uma skill, em AEC prático, é uma instrução padronizada da empresa: o saber fazer da equipe empacotado para o harness reinjetar. Não é um funcionário digital. É a ficha que diz como trabalhamos aqui.

Uma skill boa diz coisas como:

  • Quais unidades usamos (kN e m; não misturar tonf no meio do relatório).
  • Em que formato apresentar resultados (tabela com IDs, unidades visíveis, hipóteses à parte).
  • Em que livro, código ou norma se basear (edição citada; não «o que o modelo lembra»).
  • Como nomear camadas, cargas, casos ou arquivos (convenção do escritório, não inventiva do chat).
  • Quando parar e perguntar (falta o modelo, falta a edição normativa, a tool falhou: não preencher a lacuna).

Nenhuma dessas linhas é mágica. São a cultura do escritório escrita para não depender de quem está hoje no chat. O harness pode anexar esse procedimento a uma sessão ou missão já aberta. Não é o modelo. Não é o solver. Não é a assinatura.

Se adere

Vai com quem já está trabalhando. Como a ficha no bolso do engenheiro de planta.

Não abre contexto novo

O agente ocupa contexto novo: pasta limpa, mesa nova — muitas vezes fora do fio principal do harness. A skill não. Ordena a janela que você já tem.

É procedimento, não personalidade

Uma skill boa se pode auditar: passos, entradas, saídas, o que é proibido. Um «agente carismático» sem ficha é teatro. Uma ficha sem quem a execute é papel.

Exemplos de ficha que de fato se sentem em AEC

Demo de mesa — não caso de cliente —:

Unidades e apresentação. «Sempre kN e m. Toda tabela leva unidade no cabeçalho. Se o arquivo vier em outra unidade, converta e diga. Não invente IDs. Se o modelo não estiver aberto, pare e pergunte.»

Norma e fonte. «Baseie-se na edição da norma que está na pasta do projeto. Cite artigo ou seção. Se a edição não estiver, não complete a lacuna: pare e peça o PDF correto.»

Preflight antes do solve. «Antes de chamar o motor: seleção não vazia, bounds razoáveis, unidades do caso. Se o preflight falhar, não queime o solve. Registre o erro. Pergunte.»

Outras fichas típicas: convenção de nomes de cargas; modelo do relatório rastreável; quando pedir aprovação antes de tocar o modelo oficial. A ficha não abre a sala; o agente sim.

Skill frente a agente: mesma oficina, peças distintas

Agente: você manda um engenheiro para outra sala com pasta limpa. Missão própria. Mesa nova. Volta com entregável.

Skill: você dá a quem já está — ou ao agente que já mandou — a ficha plastificada. A instrução padronizada da empresa. Não contrata mais ninguém. Não estreia cabeça.

Se precisa de uma missão isolada — revisar só o nível 3 sem o chat do orçamento —, abre um agente. Pode colar skills: a ficha viaja na pasta limpa, mas a sala nova foi aberta pelo agente, não pela ficha.

Por que AEC confunde skill com «outro estagiário digital»

Porque o marketing vende tudo como agente. E porque a dor real é «ninguém segue o procedimento».

Contratar cabeças (agentes) sem fichas (skills) multiplica salas que improvisam. Colar fichas sem harness é ter procedimentos padrão que ninguém carrega. A ordem sã:

  1. Escreva o procedimento como skill auditável — instrução padronizada da empresa.
  2. Adira-o às sessões ou missões que já existem.
  3. Abra um agente só quando a missão exige contexto novo.
  4. Mantenha o motor (OpenSees, CalculiX, IfcOpenShell…) como quem calcula.
  5. Assine você.

A crença a quebrar: «se o modelo é bom, não preciso de procedimento padrão». Ao contrário. Quanto mais capaz o modelo, mais caro é deixar o procedimento só na cabeça de uma pessoa ou num chat que se compacta.

O que não é uma skill

Primeira. «Você sobe um PDF da norma, já tem uma skill.» Você tem um arquivo. Uma skill é o procedimento de como usá-lo: o que citar, quando parar.

Segunda. «A skill substitui o engenheiro.» Não. Substitui a reescrita caótica do mesmo checklist. O julgamento e a assinatura continuam humanos.

Terceira. «Skill = agente pequenino.» Não. A diferença é contexto: a skill não abre uma cabeça nova; o agente sim ocupa contexto novo.

Quarta. «Com uma skill já não preciso de harness.» O harness é a oficina. A ficha vive aí. Sem oficina, a ficha é mais um parágrafo no prompt — e na terceira pergunta se dilui.

Se quiser o mapa do arnês, leia o que é um harness de IA. Se o que falta é outra sala, não outra ficha, volte ao papel do agente.

Avaliação e limitações

Trate as notas abaixo como contexto de avaliação, não como um cálculo ou uma verificação comprovados.

Trate a skill como um procedimento curto e versionado. Se a norma aplicável muda, mude o cartão — não um fio velho.