Skills

Deskcomm Prompt

Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando, ...

Install

npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -g -a claude-code -y
Category
AI and agents
Updated
3d ago
License
MIT
Context cost
Lightabout 1,232 tokens
Runs scripts
No, instructions only

What it does

Guia para afinar o prompt de um agente de IA do DeskcommCRM que não está performando, como um engenheiro de prompt sênior de atendimento e vendas, com dados da operação, não achismo. Use SEMPRE que alguém disser "o agente responde errado", "está robótico", "passa tudo para humano", "não usa a agenda", "inventa preço", "fala demais", "não converte", "melhora o prompt", "otimiza o agente", ou quiser revisar, reescrever ou comparar versões do prompt. Diagnostica pelas execuções, vetos e custos, propõe a versão nova em rascunho, testa pelo botão Testar e deixa o Publicar com a pessoa.

Afinar o prompt de um agente com dados

"O agente está ruim" quase nunca é o prompt inteiro. Às vezes é o roteador mandando para o agente errado; às vezes é um portão de saída vetando por vocabulário que o próprio prompt ensinou; às vezes é a base de conhecimento que não cobre; às vezes é o horário. Otimizar prompt sem olhar os dados troca um problema por outro. Este guia diagnostica primeiro.

Como você age

  • Sabe o que o prompt controla e o que não controla. O texto do agente é uma camada dentro de um prompt montado pelo motor, e onze portões barram a resposta na saída. Reescrever regra que o motor já impõe é ruído; escrever jargão ou "encaminhe ao gerente" cria veto e mata a agenda. Lista completa em references/anatomia-e-antipadroes.md.
  • Diagnóstico antes da reescrita. Execuções, vetos, handoffs, consultas à base, custo por turno: references/diagnostico.md. Só depois disso você abre o prompt.
  • Amostra mínima de conversa, com ciência da pessoa. Ler mensagens é ler dado pessoal de terceiros. Quando for indispensável, poucas conversas, só o trecho, só na instalação, e a pessoa sabe. Preferir agregados (o guia deskcomm-metricas cobre).
  • Versão nova, nunca edição. A otimização vira uma versão em rascunho, testada pelo botão Testar com o mesmo roteiro antes e depois; o clique em Publicar é da pessoa. Versão publicada é imutável e reversível.
  • Uma mudança por vez, medida. Trocar cinco coisas e a conversão subir não ensina nada.

Passo 0, o que a pessoa vê

Uma pergunta por vez: qual agente; o que acontece (a frase exata que incomoda, se houver); desde quando; o que mudou perto disso (versão publicada, materiais, roteador, número novo). Descubra a versão publicada e a data, as métricas comparam "antes/depois" por essa data.

Passo 1, o diagnóstico

Read the whole SKILL.md on GitHub

More in AI and agents