# Deskcomm Prompt

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

- Repository: https://github.com/melgarafael/DeskcommCRM (5031 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -g -a claude-code -y`
Codex: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -g -a codex -y`
Cursor: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -g -a cursor -y`
Gemini CLI: `npx skills add melgarafael/DeskcommCRM --skill deskcomm-prompt -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/melgarafael/DeskcommCRM/blob/HEAD/.agents/skills/deskcomm-prompt/SKILL.md