Como usar e gerenciar habilidades de IA

• Break Down Complex Requirements – analisar os requisitos selecionados e dividi-los em requisitos menores, que possam ser testados de forma independente, preservando a intenção original.

  Exemplo de prompt:

  Break down these requirements.

• Apply Requirement Writing Standards – revisar os requisitos e reescrevê-los 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 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 o significado técnico, a terminologia, os IDs e as 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 os requisitos e propor métodos de verificação, critérios de aceitação ou condições de teste que possam ser usados para demonstrar a 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 habilidade ajuda a IA a entender duas coisas:

• Quando a habilidade deve ser usada

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

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 – definem 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 facilitar a leitura rápida na lista de habilidades

• Focado na tarefa principal executada pela habilidade

• Escrito em uma linguagem que os usuários entendam 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 curta

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

Uma boa descrição curta 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 curta deve ser concisa, mas não vaga. Ela deve incluir contexto suficiente para que a IA possa distinguir essa habilidade de outras semelhantes.

Uma descrição curta fraca apenas indica a qual domínio a habilidade pertence. Uma descrição curta forte explica a tarefa específica, o contexto esperado e a situação que deve acionar seu uso. Por exemplo, em vez de descrever uma habilidade como algo que "ajuda com requisitos", a descrição deve explicar se ela avalia a qualidade dos requisitos, decompõe requisitos complexos, traduz o texto dos requisitos, detecta conflitos, gera critérios de verificação ou realiza outra ação específica.

Quanto melhor a descrição curta explicar a finalidade e o contexto de uso da habilidade, maior será a confiabilidade com que o assistente poderá decidir quando aplicá-la.

Instruções

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

Boas instruções devem ser escritas como orientações claras e 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 produzir esse resultado.

As instruções devem explicar:

• O que a IA deve analisar primeiro – em geral, o assistente deve compreender a intenção de engenharia, o contexto, a estrutura ou as relações antes de alterar ou gerar qualquer coisa.

• Quais etapas a IA deve executar – o comportamento deve ser dividido em etapas explícitas, para que o resultado seja reproduzível e previsível.

• O que a IA deve preservar – isso pode incluir a intenção original, os IDs dos requisitos, os termos técnicos, as unidades, os valores, as restrições, as referências, a aplicabilidade, a hierarquia ou o contexto de rastreabilidade.

• O que a IA não deve fazer – 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.

• Como a IA deve lidar com a incerteza – se houver informações ausentes, ambíguas ou insuficientes, a habilidade deve orientar a IA a apontar claramente o problema, em vez de fazer suposições.

• Qual formato de saída é esperado – a habilidade deve definir se o resultado deve 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 no trabalho de engenharia, pois o assistente pode estar trabalhando com dados que afetam especificações, validação, decisões de projeto ou etapas posteriores de implementação. Portanto, a habilidade deve orientar a IA a ser útil sem demonstrar confiança excessiva.

Outras observações

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

• Mantenha as habilidades focadas

  Uma habilidade deve executar bem uma 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 confiarem 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 não relacionadas, divida-a em habilidades separadas.

• Defina os limites com clareza

  Boas habilidades estabelecem limites explícitos.

  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.

  Alguns limites úteis incluem:

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

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

  • Não remover IDs ou referências

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

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

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

  Limites claros reduzem o risco de resultados de engenharia plausíveis, mas incorretos.

• Defina o formato de saída

  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, a saída 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 contêm colunas de problema, explicação e recomendação. Habilidades voltadas à reescrita costumam funcionar bem quando apresentam o texto original, a versão proposta e a justificativa.