Engenharia de Requisitos Agêntica

• Break Down Complex Requirements – analisar requisitos selecionados e dividi-los em requisitos menores, testáveis de forma independente, preservando a intenção original.

  Exemplo de prompt:

  Break down these requirements.

• Apply Requirement Writing Standards – revisar requisitos e reescrevê-los 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, ausência de atores e critérios de aceitação pouco claros.

  Exemplo de prompt:

  Rewrite these requirements according to our requirement quality standard.

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

  Exemplo de prompt:

  Translate these requirements to German.

• Classify Requirements – aplicar um esquema de classificação organizacional aos requisitos, 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 – analisar requisitos e propor 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 – gerar 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 – definem o comportamento que a IA deve seguir depois que a skill for selecionada.

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

Nome

O Name deve ser curto, claro e orientado à 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 dados de engenharia com os quais a skill trabalha.

Um nome forte para skill 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 amplos ou genéricos demais. Se o nome puder se aplicar a muitas tarefas diferentes, provavelmente ele não é específico o suficiente.

Descrição curta

A Short Description ajuda a IA a entender do que se trata a skill e quando ela deve ser acionada. Este 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 alguma 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

• Qual 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 consiga distinguir essa skill de skills semelhantes.

Uma descrição curta fraca apenas informa 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, com mais confiabilidade o assistente poderá decidir quando aplicá-la.

Instruções

As Instructions definem o que a IA deve fazer depois que a skill tiver sido 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 de engenharia, o contexto, a estrutura ou os relacionamentos 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 mudanças 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 claramente o problema 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 trabalho 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 ser excessivamente confiante.

Outras observações

• 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 única tarefa repetível.

  Se uma skill tentar fazer coisas demais, fica 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 intencionalmente parte de um fluxo de trabalho único e bem 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 assumir.

  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 assuma 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 fato

  Limites claros reduzem o risco de uma saída de engenharia plausível, porém incorreta.

• Define the Output Format

  Uma skill deve informar à 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

  • Um checklist

  • Um resumo

  • Uma lista de alterações propostas

  • Um conjunto de perguntas ou questões em aberto

  O formato de 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.