Engenharia de requisitos baseada em agentes

• Break Down Complex Requirements – analisa os requisitos selecionados e os divide em requisitos menores, que podem ser testados de forma independente, preservando a intenção original.

  Exemplo de prompt:

  Break down these requirements.

• Apply Requirement Writing Standards – revisa os requisitos e os reescreve de acordo com as diretrizes de redação de requisitos da sua organização. As verificações típicas incluem ambiguidade, linguagem não verificável, ausência de agentes 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 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 – analisa os 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 forma.

  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 habilidade ajuda a IA a compreender duas coisas:

• Quando a habilidade deve ser usada

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

Ao definir uma habilidade, 

Isso é expresso por meio de três campos, cada um com uma finalidade diferente:

• Name – ajuda você a reconhecer a habilidade.

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

• Instructions – define o comportamento que a IA deve seguir após a seleção da habilidade.

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 habilidade se propõe a fazer. Um bom nome geralmente descreve a ação e o tipo de dados de engenharia com os quais a habilidade trabalha.

Um bom nome de habilidade deve ser:

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

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

• Focado na tarefa principal realizada pela habilidade

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

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

Descrição breve

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

Uma boa descrição breve deve explicar:

• Qual tarefa a habilidade executa

• A que tipo de dados de engenharia ela se aplica

• Quando a habilidade deve ser usada

• Qual resultado se espera que a habilidade produza

A descrição breve deve ser concisa, mas não vaga. Ela deve incluir contexto suficiente para que a IA diferencie essa habilidade de outras semelhantes.

Uma descrição breve fraca apenas indica a área à qual a habilidade pertence. Uma descrição breve forte explica a tarefa específica, o contexto esperado e a situação que deve acioná-la. Por exemplo, em vez de descrever uma habilidade como algo que "ajuda com requisitos", a descrição deve explicar se ela revisa a qualidade dos requisitos, decompõe requisitos complexos, traduz o texto dos requisitos, detecta conflitos, gera critérios de verificação ou executa outra ação específica.

Quanto melhor a descrição breve explicar a finalidade da habilidade e seu contexto de uso, mais confiável será a decisão do assistente sobre quando aplicá-la.

Instruções

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

Boas instruções devem ser redigidas como orientações claras, passo a passo. Elas devem descrever não apenas o resultado final, mas também o raciocínio e as restrições que a IA deve seguir ao produzi-lo.

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 as relações antes de alterar ou gerar qualquer coisa.

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

• What the AI should preserve – isso pode incluir a 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 habilidades 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 houver informações ausentes, ambíguas ou insuficientes, a habilidade deve instruir a IA a indicar claramente o problema, em vez de fazer suposições.

• What output format is expected – a habilidade deve definir se o resultado será uma tabela, uma lista com marcadores, um texto reescrito, um resumo, uma lista de verificação ou um relatório estruturado.

Boas instruções são especialmente importantes para o trabalho de engenharia, pois o assistente pode lidar com dados que afetam especificações, validação, decisões de projeto ou a implementação posterior. Portanto, a habilidade deve orientar a IA a ser útil sem demonstrar confiança excessiva.

Outras observações

• O objetivo não é escrever uma solicitação longa. O objetivo é definir um procedimento operacional claro para a IA.

• Keep Skills Focused

  Uma habilidade deve executar bem uma única tarefa reproduzível.

  Se uma habilidade tentar fazer coisas demais, será mais difícil para o assistente saber quando usá-la e para os usuários confiar no resultado. Por exemplo, uma única habilidade não deve combinar decomposição de requisitos, tradução, revisão de qualidade, análise de rastreabilidade e geração de verificações, a menos que essas ações façam parte, intencionalmente, de um único fluxo de trabalho bem delimitado.

  Se a finalidade da habilidade exigir várias ações sem relação entre si, divida-a em habilidades separadas.

• Define Boundaries Clearly

  Boas habilidades definem seus limites explicitamente.

  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 resultados de engenharia plausíveis, mas incorretos.

• Define the Output Format

  Uma habilidade deve informar à IA como apresentar o resultado.

  Um formato de saída consistente facilita a revisão, a comparação e a reutilização da habilidade.

  Dependendo da habilidade, o resultado pode ser:

  • Uma tabela

  • Uma lista com marcadores

  • Um requisito reescrito

  • Um relatório estruturado

  • Uma lista de verificação

  • 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 habilidade. Por exemplo, habilidades voltadas à revisão costumam funcionar bem com tabelas que tenham colunas para problema, explicação e recomendação. Habilidades voltadas à reescrita costumam funcionar bem quando apresentam o texto original, o resultado proposto e a justificativa.