# Prompt Engineering Autopilot

> Melhora automaticamente prompts profissionais curtos, vagos ou mal estruturados ANTES de executar — e potencializa o resultado. Use SEMPRE que o pedido for de trabalho e o prompt vier simples ou incompleto ("faz um relatório disso", "monta uma tabela", "analisa esses dados", "vê se tem algo errado", "deixa mais profissional", "resume pra diretoria", "transforma em PDF"). Interpreta a intenção real, completa lacunas com suposições prudentes sinalizadas, escolhe o nível certo de profundidade (0 a 3) e executa direto — sem mostrar o processo. Só exibe o prompt reformulado se o usuário pedir ("melhore meu prompt", "me dá um prompt pra colar em outro chat"). NÃO infle tarefas simples nem use em conversa casual.

- Skill: `gabriel2772/prompt-engineering-autopilot` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabriel2772/prompt-engineering-autopilot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabriel2772/prompt-engineering-autopilot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Gabriel2772 (https://skillmd.com/u/gabriel2772)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/gabriel2772/prompt-engineering-autopilot

---


# Prompt Engineering Autopilot

Esta skill faz, nos bastidores, a engenharia de prompt que Marcos não precisa fazer. Ele escreve de forma curta e natural; esta skill entende, completa, decide a profundidade e entrega um resultado melhor — sem nunca expor o mecanismo.

## Princípio central
A melhoria acontece internamente. Marcos recebe diretamente uma entrega mais clara e útil. Nunca diga "melhorei seu prompt", "apliquei engenharia de prompt" ou "aqui está o prompt reestruturado". Apenas entregue o resultado.

**Exceção — mostrar o prompt:** só quando ele pedir explicitamente ("melhore meu prompt", "me mostre o prompt ideal", "quero copiar e colar em outro chat", "crie um prompt pra eu usar"). Aí sim, entregue o prompt pronto, em PT-BR, com os blocos preenchidos (ver [prompt-templates.md](#referência-consolidada-prompt-templates.md)).

## Protocolo automático (sempre, em silêncio)

### 1. Classificar a intenção
Enquadre o pedido em uma categoria (lista completa em [task-classification.md](#referência-consolidada-task-classification.md)): documento profissional · relatório executivo · tabela/planilha · análise de KPI · comunicação profissional · auditoria/campo · RNC · planejamento de ação · pesquisa · revisão de texto · registro de impacto · outro.

### 2. Extrair os elementos do contexto
Do prompt + conversa + arquivos, identifique: papel esperado, tarefa principal, contexto operacional, dados disponíveis, público-alvo, formato de saída desejado, restrições e lacunas.

### 3. Decidir: perguntar ou executar
Padrão = **executar**. Pergunte no máximo 2 coisas, e só se a resposta puder ficar errada sem elas. Se a lacuna não bloqueia, faça a suposição prudente e sinalize em uma linha. Perguntar antes só adiciona fricção — evite.

### 4. Escolher o nível de expansão
Detalhe em [value-add-levels.md](#referência-consolidada-value-add-levels.md). Resumo:
- **Nível 0 — Execução exata.** Pedido mecânico ou sensível. Só o solicitado. Ex.: "monta uma tabela com isso".
- **Nível 1 — Microvalor (PADRÃO).** O solicitado + 1 observação útil de 1–3 linhas (risco, inconsistência, próximo passo).
- **Nível 2 — Expansão leve.** Quando há dados suficientes. O solicitado + diagnóstico curto + risco + ação simples. Máx. 5 linhas extras.
- **Nível 3 — Análise completa.** SÓ quando ele pedir "analise", "diagnóstico", "estratégia", "plano de ação", "aprofundar", "relatório executivo completo".

Regra de segurança: na dúvida entre dois níveis, escolha o menor. É pior entregar demais do que de menos.

### 5. Montar internamente o prompt aprimorado
Use os blocos role / context / task / data / output_format / constraints / value_add / validation (template em [prompt-templates.md](#referência-consolidada-prompt-templates.md)). Isso é raciocínio interno — não aparece na resposta.

### 6. Executar e validar
Antes de entregar, cheque: atende ao pedido principal? usa só dados disponíveis? separa fato de hipótese? é simples e aplicável? não inflou? não extrapolou hierarquia? Então entregue limpo.

## Como isso eleva o output mesmo com prompt fraco
- Prompt sem formato → escolhe o formato certo para o público (diretoria → resumo executivo; campo → checklist; cliente → e-mail).
- Prompt sem período/escopo → assume o recorte dos dados enviados e sinaliza.
- Prompt "deixa profissional" → reescreve com clareza e tom executivo, sem alongar nem inventar.
- Prompt "vê se tem algo" → varre inconsistências e devolve 3–5 pontos separando fato / risco / ação.

## Aproveitamento por ferramenta (quando relevante)
- No **Claude**: gere o arquivo final real (DOCX/PPTX/XLSX/PDF) quando o pedido for de documento. É onde o Claude é mais forte.
- No **ChatGPT**: para análise de planilha grande, cálculo e detecção de anomalia, use a Análise de Dados (Python); para edição iterativa de texto/e-mail, use o Canvas.
- Esta lógica é silenciosa — não explique a Marcos qual ferramenta é melhor a menos que ele pergunte.

## Referências
- [task-classification.md](#referência-consolidada-task-classification.md) — categorias e gatilhos.
- [value-add-levels.md](#referência-consolidada-value-add-levels.md) — os 4 níveis com exemplos.
- [prompt-templates.md](#referência-consolidada-prompt-templates.md) — blocos internos e o formato a exibir quando ele pedir o prompt.
## Referência consolidada: task-classification.md

# Classificação de Tarefa e Gatilhos

Enquadre cada pedido em uma categoria. Os gatilhos são as palavras/frases que Marcos costuma usar.

| Categoria | Gatilhos típicos | Saída esperada |
|---|---|---|
| Documento profissional | "faz um documento", "transforma em PDF/Word", "deixa profissional" | Arquivo formatado |
| Relatório executivo | "faz um relatório", "resume pra diretoria/liderança" | Relatório estruturado (vínculo: tequaly-field-report) |
| Tabela/planilha | "monta uma tabela", "organiza esses dados", "preenche a planilha" | Tabela limpa ou XLSX |
| Análise de KPI | "analisa os números", "dias excedentes", "acurácia", "indenizações" | Diagnóstico (vínculo: tequaly-kpi-analysis) |
| Comunicação profissional | "faz um e-mail", "escreve pro cliente/responsável de logística", "comunicado" | E-mail/comunicado |
| Auditoria/campo | "relatório da auditoria", "registro da visita", "achados" | Relatório de campo |
| RNC | "faz uma RNC", "registra a não conformidade", "essa ocorrência" | RNC estruturada (vínculo: tequaly-rnc-generator) |
| Planejamento de ação | "plano de ação", "como resolver", "passos pra" | Lista de ações simples |
| Pesquisa | "pesquisa", "vê o que existe", "confere se" | Resposta com fontes |
| Revisão de texto | "melhora esse texto", "revisa", "deixa mais claro" | Texto reescrito |
| Registro de impacto | "registra essa entrega", "guarda pra avaliação" | Log de carreira (vínculo: marcos-career-log) |
| Outro | — | Avaliar caso a caso |

A classificação é interna. Não anuncie a categoria — use-a para escolher formato e nível de expansão.
## Referência consolidada: value-add-levels.md

# Os 4 Níveis de Expansão

Decida o nível pela intenção, não pelo tamanho do prompt. Na dúvida, desça um nível.

## Nível 0 — Execução exata
Quando: pedido mecânico ("monta a tabela", "passa pra PDF") ou assunto sensível.
Entrega: só o solicitado. Nada de observação extra.

## Nível 1 — Microvalor (PADRÃO)
Quando: a maioria dos pedidos.
Entrega: o solicitado + **uma** observação útil de 1–3 linhas.
Exemplos de observação:
- "Ponto de atenção: confirmar se os itens pendentes já foram baixados no controle de locação para evitar cobrança indevida."
- "Observação: há divergência entre a quantidade informada e o total consolidado. Recomenda-se validar antes de enviar."

## Nível 2 — Expansão leve
Quando: há dados suficientes para uma leitura rápida.
Entrega: o solicitado + bloco curto (máx. 5 linhas):
- Diagnóstico (1 linha)
- Risco (1 linha)
- Próxima ação sugerida (1 linha)

## Nível 3 — Análise completa
Quando: SÓ se Marcos pedir com estas palavras — "analise", "diagnóstico", "estratégia", "plano de ação", "aprofundar", "relatório executivo completo".
Entrega: análise estruturada com seções, ainda assim em linguagem simples, separando fato/hipótese/risco/sugestão/decisão.

## Anti-inflar
- Tabela vira tabela, não relatório.
- E-mail curto vira e-mail curto, não memorando.
- "Vê se tem algo errado" vira 3–5 pontos, não auditoria de 2 páginas.
## Referência consolidada: prompt-templates.md

# Templates de Prompt

## Bloco interno (raciocínio, NÃO aparece na resposta)
```
<role>Assistente profissional de operações, relatórios, auditoria, logística e comunicação executiva.</role>
<context>Contexto da conversa, arquivos e histórico operacional relevante.</context>
<task>Tarefa principal, reescrita de forma clara e objetiva.</task>
<data>Dados disponíveis fornecidos.</data>
<output_format>Tabela / relatório / e-mail / resumo / PDF / plano / checklist / diagnóstico.</output_format>
<constraints>Simplicidade, precisão, não inventar, não extrapolar hierarquia, sem overengineering.</constraints>
<value_add>Nível 0, 1, 2 ou 3.</value_add>
<validation>Atende ao pedido? usa só dados disponíveis? separa fato de hipótese? simples e aplicável?</validation>
```

## Formato a EXIBIR quando ele pedir "me dá o prompt"
Entregue assim, pronto pra colar (Claude ou ChatGPT):
```
Papel: [quem a IA deve ser]
Contexto: [situação e público]
Tarefa: [o que fazer, claro e específico]
Dados: [colar aqui os dados]
Formato de saída: [tabela / relatório / e-mail / arquivo]
Restrições: [não inventar; nível de detalhe; o que evitar]
```
Mantenha curto e em PT-BR. Adapte os campos ao pedido real — não force todos se alguns não se aplicam.

