Engenharia Agentic

• Break Down Complex Requirements – analisa os requisitos selecionados e os divide em requisitos menores, testáveis de forma independente, preservando a intenção original.

  Exemplo de prompt:

  Break down these requirements.

• Apply Requirement Writing Standards – revisa requisitos e os reescreve de acordo com as diretrizes da sua organização para redação de requisitos. As verificações típicas incluem ambiguidade, linguagem não verificável, atores ausentes e critérios de aceitação pouco claros.

  Exemplo de prompt:

  Rewrite these requirements according to our requirement quality standard.

• Translate Requirements – traduz requisitos de um idioma para outro, preservando o significado técnico, a terminologia, os IDs e as referências de rastreabilidade.

  Exemplo de prompt:

  Translate these requirements to German.

• Classify Requirements – aplica aos requisitos um esquema de classificação organizacional, como Eletrônica, Mecânica, Software, Segurança funcional, Segurança da informação ou outras taxonomias específicas da empresa.

  Exemplo de prompt:

  Classify these requirements according to our applicability model.

• Generate Verification Criteria – analisa requisitos e propõe métodos de verificação, critérios de aceitação ou condições de teste que possam ser usados para demonstrar conformidade sempre da mesma maneira.

  Exemplo de prompt:

  Generate verification criteria for these requirements.

• Summarize a Specification/Section/Group of Requirements – gera um resumo conciso e estruturado de uma especificação, seção de requisitos ou conjunto de requisitos.

  Exemplo de prompt:

  Summarize the selected requirements.

Uma boa skill ajuda a IA a entender duas coisas:

• Quando a skill deve ser usada

• O que a IA deve fazer quando a skill for executada

Ao definir uma skill, 

Isso é expresso por meio de três campos, em que cada campo tem uma finalidade diferente:

• Name – ajuda você a reconhecer a skill.

• Short Description – ajuda a IA a decidir quando a skill é relevante.

• Instructions – define o comportamento que a IA deve seguir assim que a skill for selecionada.

Consulte as seções abaixo para obter detalhes sobre cada campo.

Name

O Name deve ser curto, claro e orientado para a ação. Ele deve ajudar você a entender rapidamente o que a skill se propõe a fazer. Um bom nome geralmente descreve a ação e o tipo de dado de engenharia com o qual a skill trabalha.

Um nome de skill forte deve ser:

• Específico o suficiente para distinguir a skill das demais

• Curto o suficiente para ser facilmente identificado na lista de skills

• Focado na tarefa principal que a skill executa

• Escrito em uma linguagem que os usuários entendam naturalmente

Evite nomes excessivamente amplos ou genéricos. Se o nome puder se aplicar a muitas tarefas diferentes, provavelmente não é específico o suficiente.

Short Description

A Short Description ajuda a IA a entender do que se trata a skill e quando ela deve ser acionada. Esse campo é importante porque você não precisa selecionar manualmente uma skill. O assistente analisa seu prompt, compara-o com as skills disponíveis e decide se uma skill é relevante.

Uma boa descrição curta deve explicar:

• Que tarefa a skill executa

• A que tipo de dados de engenharia ela se aplica

• Quando a skill deve ser usada

• Que resultado se espera que a skill produza

A descrição curta deve ser concisa, mas não vaga. Ela deve incluir contexto suficiente para que a IA distinga essa skill de skills semelhantes.

Uma descrição curta fraca apenas diz a qual domínio a skill pertence. Uma descrição curta forte explica a tarefa específica, o contexto esperado e a situação de acionamento. Por exemplo, em vez de descrever uma skill como algo que “ajuda com requisitos”, a descrição deve explicar se a skill revisa a qualidade dos requisitos, decompõe requisitos complexos, traduz texto de requisitos, detecta conflitos, gera critérios de verificação ou executa outra ação específica.

Quanto melhor a descrição curta explicar a finalidade da skill e o contexto de uso, mais confiavelmente o assistente poderá decidir quando aplicá-la.

Instructions

As Instructions definem o que a IA deve fazer depois que a skill for selecionada. Este é o campo mais importante para controlar o comportamento da skill. Enquanto a descrição curta ajuda a IA a decidir quando usar a skill, as instruções definem como a skill deve ser executada.

Boas instruções devem ser escritas como orientações claras, passo a passo. Elas não devem apenas descrever a saída final, mas também o raciocínio e as restrições que a IA deve seguir ao produzir essa saída.

As instruções devem explicar:

• What the AI should analyze first – o assistente normalmente deve compreender a intenção, o contexto, a estrutura ou os relacionamentos de engenharia antes de alterar ou gerar qualquer coisa.

• What steps the AI should perform – o comportamento deve ser dividido em etapas explícitas, para que a saída seja repetível e previsível.

• What the AI should preserve – isso pode incluir intenção original, IDs de requisitos, termos técnicos, unidades, valores, restrições, referências, aplicabilidade, hierarquia ou contexto de rastreabilidade.

• What the AI must not do – boas skills impedem explicitamente que a IA invente detalhes de engenharia ausentes, altere a intenção, introduza novas suposições ou aplique alterações sem revisão do usuário.

• How the AI should handle uncertainty – se as informações estiverem ausentes, ambíguas ou insuficientes, a skill deve instruir a IA a indicar o problema claramente em vez de adivinhar.

• What output format is expected – a skill deve definir se o resultado deve ser uma tabela, lista com marcadores, texto reescrito, resumo, checklist ou relatório estruturado.

Boas instruções são especialmente importantes para trabalhos de engenharia porque o assistente pode estar trabalhando com dados que afetam especificações, validação, decisões de projeto ou implementação posterior. Portanto, a skill deve orientar a IA a ser útil sem demonstrar excesso de confiança.

Other Notes

• O objetivo não é escrever um prompt longo. O objetivo é definir um procedimento operacional claro para a IA.

• Keep Skills Focused

  Uma skill deve executar bem uma tarefa repetível.

  Se uma skill tentar fazer muitas coisas, ficará mais difícil para o assistente saber quando usá-la e mais difícil para os usuários confiarem na saída. Por exemplo, uma skill não deve combinar decomposição de requisitos, tradução, revisão de qualidade, análise de rastreabilidade e geração de verificação, a menos que essas ações façam parte intencionalmente de um fluxo de trabalho único e rigidamente definido.

  Se a finalidade da skill exigir várias ações não relacionadas, divida-a em skills separadas.

• Define Boundaries Clearly

  Boas skills são explícitas quanto aos limites.

  Isso é especialmente importante ao trabalhar com requisitos, especificações e dados de engenharia. O assistente deve saber o que pode alterar, o que deve apenas sugerir e o que nunca deve presumir.

  Limites úteis incluem:

  • Não altere a intenção original de engenharia

  • Não invente valores, restrições ou decisões de projeto

  • Não remova IDs ou referências

  • Não presuma métodos de verificação ausentes

  • Não aplique alterações automaticamente sem revisão do usuário

  • Não trate informações pouco claras como fatos

  Limites claros reduzem o risco de saídas de engenharia plausíveis, porém incorretas.

• Define the Output Format

  Uma skill deve dizer à IA como retornar o resultado.

  Um formato de saída consistente torna a skill mais fácil de revisar, comparar e reutilizar.

  Dependendo da skill, a saída pode ser:

  • Uma tabela

  • Uma lista com marcadores

  • Um requisito reescrito

  • Um relatório estruturado

  • Uma checklist

  • Um resumo

  • Uma lista de alterações propostas

  • Um conjunto de perguntas ou questões em aberto

  O formato da saída deve corresponder à finalidade da skill. Por exemplo, skills voltadas à revisão geralmente funcionam bem como tabelas com colunas de problema, explicação e recomendação. Skills voltadas à reescrita geralmente funcionam bem quando mostram o texto original, a saída proposta e a justificativa.