Skill Raio-X do Prompt

SKILL-RAIO-X-PROMPT.md

@@ -0,0 +1,53 @@
+# 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