Roadmap/ai-request-coach.md

ai-request-coach

Spec inicial de uma skill para ajudar usuários não técnicos a pedir melhor para a IA sem precisar aprender prompting “na marra”.

Problema

Muita gente sabe o que quer fazer, mas não sabe como pedir.

Pedidos típicos de usuário não técnico costumam vir assim:

O problema não é falta de intenção. É falta de estrutura. A IA normalmente precisa inferir:

Essa skill existe para reduzir esse atrito.

Objetivo

Transformar pedidos vagos ou incompletos em pedidos melhores, com menos carga cognitiva para o usuário.

Ela não deve ensinar prompt engineering como aula. Ela deve ajudar o usuário a chegar mais rápido num pedido útil.

Usuário-alvo

Resultado esperado

A skill deve ajudar a IA a fazer 5 coisas:

  1. Inferir a intenção principal do usuário
  2. Detectar lacunas relevantes de contexto
  3. Fazer poucas perguntas boas, em vez de jogar um questionário enorme
  4. Sugerir uma formulação melhor do pedido
  5. Oferecer modos guiados, como “rápido”, “mais seguro”, “mais detalhado” ou “feito para mim”

O que a skill faria na prática

1. Reescrever o pedido do usuário

Exemplo:

Entrada do usuário:

quero ajuda para organizar um evento

Saída intermediária:

Entendi. Você quer organizar um evento e precisa de ajuda prática. Posso te ajudar a montar plano, cronograma, divulgação, orçamento ou checklist. Se quiser, já começo com um plano simples.

2. Perguntar só o mínimo necessário

Em vez de dez perguntas, faria algo como:

3. Oferecer estrutura pronta

Exemplo:

4. Melhorar a formulação sem culpar o usuário

Em vez de:

Usar algo como:

5. Ajustar o modo de ajuda ao contexto

Exemplos de modo:

Entradas

A skill pode receber:

Saídas

A skill pode produzir uma ou mais destas saídas:

Exemplo de transformação

Caso 1, pedido muito vago

Usuário:

quero montar uma campanha

Skill ajudaria a IA a converter isso em algo como:

Posso te ajudar a montar a campanha. Para não complicar, me diz só 3 coisas: qual é a causa, para quem é a campanha, e qual o prazo. Se preferir, eu posso assumir um formato simples e já te entregar um rascunho.

Caso 2, pedido operacional

Usuário:

preciso fazer um site pra um evento

Transformação útil:

Posso montar a estrutura do site. Me ajuda só com: nome do evento, data, objetivo e onde as pessoas se inscrevem. Se quiser, já começo com uma landing page padrão e depois ajustamos.

Caso 3, contexto sensível

Usuário:

quero divulgar isso sem me expor

Transformação útil:

Entendi. Como isso envolve exposição, vou priorizar segurança e privacidade. Posso te ajudar a escolher canal, formato de publicação e o que evitar divulgar. Se quiser, começo com um plano mais seguro e conservador.

Heurísticas importantes

Menos é mais

A skill não deve burocratizar a conversa. Ela deve reduzir fricção, não aumentar.

Perguntas com alto valor informacional

Só perguntar o que muda materialmente a resposta.

Ajudar sem infantilizar

Usuário não técnico não é usuário incapaz. O tom precisa ser respeitoso.

Explicação opcional

A pessoa pode querer só ajuda prática. Explicações longas sobre prompting devem ser opt-in.

Segurança contextual

Se o pedido tocar em:

A skill deve sugerir cuidado extra ou acionar skills irmãs, como:

Modos possíveis

Modo 1, invisível

A IA melhora o pedido internamente sem falar muito disso. Melhor para fluidez.

Modo 2, assistido

A IA mostra uma versão melhorada do pedido e pede confirmação. Melhor para ensinar sem dar aula.

Modo 3, template

A IA entrega um mini formulário reutilizável. Melhor para trabalhos recorrentes.

Critérios de sucesso

A skill está funcionando bem se:

Riscos

Benchmarks / avaliação futura

Essa skill poderia ser avaliada por:

Relação com outras skills do roadmap

Esta skill conversa diretamente com:

Minha leitura

Essa pode ser uma das skills mais importantes do projeto.

Porque antes de resolver execução, benchmark ou marketplace, ela resolve uma coisa básica: ajudar a pessoa a conseguir pedir ajuda de um jeito que a IA realmente consiga transformar em ação útil.