Objetivo: ao final, o consultor monta um pedido com contexto, tarefa, formato e critério de qualidade, e sabe que especificidade vale mais que educação.
[CONTEXTO] Quem eu sou, em que projeto/módulo, do que estamos falando.
[TAREFA] O verbo específico e o escopo exato.
"Escreva a seção X e Y", não "me ajuda com".
[FORMATO] Como eu vou usar. Template, estrutura, numeração,
tamanho, público-alvo.
[CRITÉRIO] O que faz esta resposta ser boa. O que separar,
o que declarar, o que não fazer.
Não precisa dos rótulos no prompt. A ordem é o que importa: contexto primeiro, porque ele calibra tudo que vem depois.
Antes
me ajuda com uma spec de interface
Depois
Sou consultor de MM num rollout S/4HANA no Meridiano (Brasil e México).
Preciso da spec funcional de uma interface que envia pedido de compra
ao portal do fornecedor via IDoc.
Escreva duas seções: regras de negócio e tratamento de erro.
Use o template em anexo. Regras numeradas. Cada erro com código,
mensagem ao usuário e ação de recuperação.
Ao final, liste separadamente o que você assumiu e o que eu preciso
confirmar com o cliente antes de submeter.
Duas linhas que mudam a resposta mais que qualquer outra coisa:
| O que dizer | Efeito |
|---|---|
| "Escreva como um consultor sênior de MM escreveria" | Calibra vocabulário, profundidade e o que fica implícito |
| "O leitor é o key user de compras, não um técnico" | Muda o nível de explicação e o jargão |
| "Isto vai para o comitê de diretoria" | Muda tamanho, tom e o que entra no resumo |
| Não funciona | Por quê | Em vez disso |
|---|---|---|
| "Seja detalhado" | Detalhado em quê? Ele vai encompridar tudo | "Cada regra com o cenário de exceção correspondente" |
| "Faça bem feito" | Não é verificável | Diga qual é o critério |
| "Por favor, se possível" | Cortesia não é informação | Diga o que você quer |
| "Você é um especialista mundial em SAP" | Superlativo não adiciona | "Escreva como um consultor sênior de MM" |
| Escrever tudo em uma linha | Você perde as quatro camadas | Shift + Enter e separe |
Superlativo e cortesia não carregam informação. Nada aqui diz o que a spec precisa conter nem para quem é.
"Detalhada e completa" não é verificável. Ele vai encompridar sem saber onde a profundidade importa.
Correto. Contexto, tarefa, formato e critério, todos presentes.
A tarefa quase sempre está lá, mesmo que vaga.
Correto. É a camada que mais se esquece e a que mais economiza rodadas, porque ela evita que você descubra o problema só na revisão.
Cortesia não é uma das quatro camadas e não afeta o resultado.
Pode aparecer ali, mas chega tarde: o público-alvo calibra tudo que ele escreve.
Ele não tem como saber se o leitor é o key user, o desenvolvedor ou o comitê. São três textos diferentes.
Correto. Público-alvo é informação de calibração e precisa vir cedo.
Correto. Você olha o resultado e sabe imediatamente se foi feito.
Rigoroso segundo qual critério? Não dá para checar se foi cumprido.
Mesmo problema, com outras palavras.