Arquiteto de Prompts

Esta skill transforma um pedido mal formulado em um prompt profissional. Ela aplica uma estrutura comprovada — papel, contexto, tarefa, formato, restrições e exemplos — para que qualquer modelo de IA entregue respostas mais precisas, consistentes e prontas para uso, reduzindo idas e vindas.

Quando usar

• Quando a IA respondeu algo genérico, fora do tom ou incompleto.
• Quando você tem só uma ideia vaga ("escreve sobre X") e quer um prompt sério.
• Quando precisa repetir a mesma tarefa muitas vezes e quer um prompt reutilizável (template).
• Quando vai delegar uma tarefa complexa e quer reduzir o número de tentativas.
• Quando quer ensinar alguém do time a "falar com a IA" do jeito certo.

Gatilhos típicos: "melhora esse prompt", "por que a IA não entende o que eu quero", "monta um prompt pra isso", "deixa esse prompt mais específico".

O que esta skill faz

1. Diagnostica o que falta no prompt original (papel? contexto? formato de saída? restrições?).
2. Reescreve o prompt seguindo a estrutura CRAFT (Contexto, Resultado/papel, Ação, Formato, Tom).
3. Define explicitamente o formato de saída — talvez o item mais ignorado e mais impactante.
4. Adiciona restrições úteis (tamanho, público, o que evitar) e, quando faz sentido, um exemplo de saída ideal (few-shot).
5. Entrega uma versão pronta para colar e, opcionalmente, uma versão template com variáveis { }.

Como usar (passo a passo)

1. Cole seu prompt atual (ou descreva o que você quer que a IA faça).
2. Diga o objetivo final: o que você vai fazer com a resposta? Para quem é?
3. A skill diagnostica e reescreve, explicando as melhorias em uma linha.
4. Teste o prompt reescrito no seu modelo de IA preferido.
5. Se quiser reutilizar, peça a versão template com variáveis para preencher depois.

Estrutura / Template

[PAPEL]
Você é {especialista X com Y anos de experiência em Z}.

[CONTEXTO]
{Quem é você/sua empresa, situação atual, público-alvo, o que já foi tentado.}

[TAREFA]
{O que exatamente você quer. Um verbo de ação claro: escreva, analise, liste, compare...}

[FORMATO DE SAÍDA]
{Lista? Tabela? Texto corrido? Quantos itens? Quantas palavras? Em markdown?}

[RESTRIÇÕES]
- Tom: {formal, descontraído, técnico...}
- Tamanho: {limite}
- Evite: {clichês, jargão, promessas, etc.}
- Idioma: português do Brasil.

[EXEMPLO DE SAÍDA IDEAL] (opcional)
{1 exemplo curto do resultado esperado.}

Exemplo preenchido

Prompt original (fraco):

"Escreve um e-mail pra cobrar um cliente que tá devendo."

Prompt reescrito (forte):

[PAPEL]
Você é um especialista em cobrança amigável e relacionamento com clientes
de pequenas empresas brasileiras.

[CONTEXTO]
Sou dono de um estúdio de design. O cliente "Mercado Bom Preço" tem uma
fatura de R$ 1.800 vencida há 12 dias. É um bom cliente, com 2 anos de
relação, e quero preservar o relacionamento.

[TAREFA]
Escreva um e-mail de cobrança que lembre o pagamento sem soar agressivo
e ofereça um canal fácil para resolver (Pix ou parcelamento).

[FORMATO DE SAÍDA]
- Assunto do e-mail (curto, sem palavra "cobrança")
- Corpo do e-mail com no máximo 130 palavras
- Encerramento cordial com chamada para ação clara

[RESTRIÇÕES]
- Tom: cordial e profissional, nada ameaçador.
- Não mencione juros nem advogado.
- Português do Brasil.

[EXEMPLO DE SAÍDA IDEAL]
Assunto: Tudo certo com a sua fatura de maio?
Olá, equipe Bom Preço! Passando para lembrar com carinho que...

Dicas e boas práticas

• Formato de saída é mágico. Pedir "em tabela com 3 colunas" muda completamente o resultado.
• Dê um papel específico. "Especialista em SEO para e-commerce" rende mais que "assistente".
• Mostre, não só diga. Um exemplo de saída (few-shot) vale mais que três frases de instrução.
• Itere em camadas. Primeiro acerte a estrutura; depois refine o tom; por último, o tamanho.
• Salve os prompts que funcionam. Transforme em template com {variáveis} e reaproveite.

Erros comuns a evitar

• Prompt curto demais ("faz um post sobre marketing") sem contexto nem público.
• Pedir tudo de uma vez — junte no máximo 1 a 2 objetivos por prompt.
• Esquecer de dizer o formato e depois reclamar do resultado.
• Não definir o que evitar (clichês, emojis em excesso, promessas exageradas).
• Aceitar a primeira resposta sem refinar — bons prompts nascem de 2 a 3 iterações.