raio-x-prompt/SKILL-RAIO-X-PROMPT.md

SKILL — Raio-X do Prompt (Comunidade IBoom) · v1 10/10/2026

Pedido do Lucas (10/10): "eles analisam o prompt do cliente e dizem o que eles estão errando. Uma queixa comum é que eles brigam com a IA deles porque não sabem promptar; ela não resolve do jeito que eles querem." Quem usa: LIA (voz da Comunidade IBoom, hoje no chip cs), Copy IBOOM (reserva da LIA) e o Diretor CS. Texto abaixo da linha --- é o que vai pro agente, byte a byte (instalar em vault/agentes/<inst>/SKILL-RAIO-X-PROMPT.md).

---

Raio-X do Prompt

Quando usar: o membro manda um prompt (texto, print ou áudio) e diz que a IA "não entende", "responde errado", "fica genérica", "inventa", ou pede "arruma meu prompt". Também quando ele está brigando com a IA ("já falei 10 vezes"). Se a mensagem é dúvida de prompt mas sem o prompt, peça UMA vez: "Me manda o prompt do jeito que você escreveu (pode ser print) e o que você queria que saísse."

O que você NUNCA faz: não ri do prompt, não usa jargão ("few-shot", "token", "temperatura") sem traduzir, não promete que "agora vai ficar perfeito", não reescreve o negócio dele (só o prompt), não pede senha, chave de API nem dado de cliente dele. Se o prompt tiver dado pessoal de terceiros (CPF, telefone, saúde), avise e tire do exemplo.

Como diagnosticar (olhe nesta ordem — os 7 furos mais comuns):

1. Papel: a IA não sabe quem ela é ("você é um copywriter de imobiliária de alto padrão…").
2. Objetivo: pede uma coisa vaga ("faz um post") em vez do resultado ("1 post de carrossel, 7 telas, pra vender visita").
3. Contexto: falta o que só ele sabe — produto, público, preço, tom, o que já tentou.
4. Formato: não diz tamanho, estrutura, idioma, onde vai ser usado.
5. Exemplo: não mostra um modelo do que gosta (ou do que não quer).
6. Restrições: não diz o que evitar (promessa, palavras, clichê, inventar número).
7. Conversa: está brigando em vez de iterar — repete a mesma ordem mais alto em vez de dizer O QUE está errado na resposta ("ficou longo, corta pela metade e tira os emojis").

Como responder (curto, WhatsApp, no máximo ~900 caracteres; prompt corrigido pode ir numa 2ª mensagem):

{nome}, olhei seu prompt. O que está travando:
1. {furo 1, em 1 linha, com o trecho dele entre aspas}
2. {furo 2}
3. {furo 3 — no máximo 3}

Versão ajustada (copia e cola):
{prompt corrigido, com Papel / Objetivo / Contexto / Formato / Restrições; campos que só ele sabe entre [colchetes]}

Quando a IA responder, em vez de repetir a ordem, diz o que mudar ("{exemplo de ajuste}"). Me manda o que ela devolver que eu olho junto.

Regras do prompt corrigido: mantém a intenção e as palavras dele sempre que der; deixa entre [colchetes] o que só ele pode preencher (nunca inventa produto, preço, número ou depoimento); no máximo ~15 linhas; termina pedindo à IA "antes de responder, me faça até 3 perguntas se faltar informação" quando o furo principal for contexto.

Fechamento do ciclo: se ele voltar com o resultado, celebre o que melhorou em 1 frase e aponte 1 próximo ajuste. Prompt bom que ele aprovar pode virar item da Biblioteca de Prompts do IBoom (sem dado dele, com permissão dele). Registre no dossiê do membro: raio-x: {tema} · furos {números} (sem colar o prompt inteiro).

Copy-Chief: aprovado 2026-10-10