Skip to content
cccskills
FreePublished on GitHub

prompt-engineering

Guia especializado em padrões de engenharia de prompts, melhores práticas e técnicas de otimização. Use quando o usuário quer melhorar prompts, aprender estratégias de prompting ou depurar comportamento de agentes.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md6.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Padrões de Engenharia de Prompts

Técnicas avançadas de engenharia de prompts para maximizar desempenho, confiabilidade e controlabilidade de LLMs.

Capacidades Centrais

1. Aprendizado com Poucos Exemplos (Few-Shot Learning)

Ensine o modelo mostrando exemplos em vez de explicar regras. Inclua 2-5 pares entrada-saída que demonstrem o comportamento desejado. Use quando você precisa de formatação consistente, padrões de raciocínio específicos ou tratamento de casos extremos. Mais exemplos melhoram a precisão, mas consomem tokens—equilibre com base na complexidade da tarefa.

Exemplo:

Extract key information from support tickets:

Input: "My login doesn't work and I keep getting error 403"
Output: {"issue": "authentication", "error_code": "403", "priority": "high"}

Input: "Feature request: add dark mode to settings"
Output: {"issue": "feature_request", "error_code": null, "priority": "low"}

Now process: "Can't upload files larger than 10MB, getting timeout"

2. Prompting com Cadeia de Pensamento (Chain-of-Thought)

Solicite raciocínio passo a passo antes da resposta final. Adicione "Vamos pensar passo a passo" (zero-shot) ou inclua exemplos de traços de raciocínio (few-shot). Use para problemas complexos que exigem lógica de múltiplas etapas, raciocínio matemático, ou quando você precisa verificar o processo de pensamento do modelo. Melhora a precisão em tarefas analíticas em 30-50%.

Exemplo:

Analyze this bug report and determine root cause.

Think step by step:

1. What is the expected behavior?
2. What is the actual behavior?
3. What changed recently that could cause this?
4. What components are involved?
5. What is the most likely root cause?

Bug: "Users can't save drafts after the cache update deployed yesterday"

3. Otimização de Prompts

Melhore prompts sistematicamente através de testes e refinamento. Comece simples, meça desempenho (precisão, consistência, uso de tokens), depois itere. Teste em entradas diversas incluindo casos extremos. Use testes A/B para comparar variações. Crítico para prompts em produção onde consistência e custo importam.

Exemplo:

Versão 1 (Simples): "Resuma este artigo"
→ Resultado: Comprimento inconsistente, perde pontos-chave

Versão 2 (Adicione restrições): "Resuma em 3 pontos"
→ Resultado: Melhor estrutura, mas ainda perde nuances

Versão 3 (Adicione raciocínio): "Identifique os 3 principais achados, depois resuma cada um"
→ Resultado: Consistente, preciso, captura informações-chave

4. Sistemas de Templates

Construa estruturas de prompts reutilizáveis com variáveis, seções condicionais e componentes modulares. Use para conversas multi-turno, interações baseadas em função, ou quando o mesmo padrão se aplica a entradas diferentes. Reduz duplicação e garante consistência entre tarefas similares.

Exemplo:

# Reusable code review template
template = """
Review this {language} code for {focus_area}.

Code:
{code_block}

Provide feedback on:
{checklist}
"""

# Usage
prompt = template.format(
    language="Python",
    focus_area="security vulnerabilities",
    code_block=user_code,
    checklist="1. SQL injection\n2. XSS risks\n3. Authentication"
)

5. Design de System Prompt

Defina comportamento global e restrições que persistem pela conversa. Configure o papel do modelo, nível de expertise, formato de saída e diretrizes de segurança. Use system prompts para instruções estáveis que não devem mudar de turno a turno, liberando tokens de mensagem de usuário para conteúdo variável.

Exemplo:

System: You are a senior backend engineer specializing in API design.

Rules:

- Always consider scalability and performance
- Suggest RESTful patterns by default
- Flag security concerns immediately
- Provide code examples in Python
- Use early return pattern

Format responses as:

1. Analysis
2. Recommendation
3. Code example
4. Trade-offs

Padrões-Chave

Divulgação Progressiva

Comece com prompts simples, adicione complexidade apenas quando necessário:

  1. Nível 1: Instrução direta

    • "Resuma este artigo"
  2. Nível 2: Adicione restrições

    • "Resuma este artigo em 3 pontos, focando nos achados-chave"
  3. Nível 3: Adicione raciocínio

    • "Leia este artigo, identifique os achados principais, depois resuma em 3 pontos"
  4. Nível 4: Adicione exemplos

    • Inclua 2-3 resumos de exemplo com pares entrada-saída

Hierarquia de Instruções

[Contexto do Sistema] → [Instrução da Tarefa] → [Exemplos] → [Dados de Entrada] → [Formato de Saída]

Recuperação de Erros

Construa prompts que tratam falhas graciosamente:

  • Inclua instruções de fallback
  • Solicite pontuações de confiança
  • Peça interpretações alternativas quando incerto
  • Especifique como indicar informação faltante

Melhores Práticas

  1. Seja Específico: Prompts vagos produzem resultados inconsistentes
  2. Mostre, Não Diga: Exemplos são mais efetivos que descrições
  3. Teste Extensivamente: Avalie em entradas diversas e representativas
  4. Itere Rapidamente: Pequenas mudanças podem ter grandes impactos
  5. Monitore Desempenho: Rastreie métricas em produção
  6. Controle de Versão: Trate prompts como código com versionamento apropriado
  7. Documente Intenção: Explique por que prompts são estruturados como são

Armadilhas Comuns

  • Over-engineering: Começar com prompts complexos antes de tentar simples
  • Poluição de exemplos: Usar exemplos que não correspondem à tarefa alvo
  • Overflow de contexto: Exceder limites de token com exemplos excessivos
  • Instruções ambíguas: Deixar espaço para múltiplas interpretações
  • Ignorar casos extremos: Não testar em entradas incomuns ou limítrofes

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Especialista em construir experiências 3D para a web - Three.js, React Three Fiber, Spline, WebGL e cenas 3D interativas. Cobre configuradores de produtos, portfólios 3D, websites imersivos e adição de profundidade às experiências web. Use quando: website 3D, three.js, WebGL, react three fiber, experiência 3D.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Quando o usuário quer planejar, projetar ou implementar um teste A/B ou experimento. Também use quando o usuário menciona "teste A/B", "split test", "experimento", "testar essa mudança", "copy variante", "teste multivariado" ou "hipótese". Para implementação de rastreamento, veja analytics-tracking.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Auditar e melhorar a acessibilidade web seguindo as diretrizes WCAG 2.1. Use quando solicitado para "melhorar acessibilidade", "auditoria a11y", "conformidade WCAG", "suporte a leitor de tela", "navegação por teclado" ou "tornar acessível".

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Testes e benchmarking de agentes LLM incluindo testes comportamentais, avaliação de capacidades, métricas de confiabilidade e monitoramento em produção—onde até os melhores agentes alcançam menos de 50% em benchmarks do mundo real. Use quando: testes de agentes, avaliação de agentes, benchmark de agentes, confiabilidade de agentes, teste de agentes.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Criar, gerenciar e orquestrar agentes de IA usando o CLI AI Maestro. Use quando o usuário pedir para "criar agente", "listar agentes", "deletar agente", "hibernar agente", "despertar agente", "instalar plugin", "mostrar agente", "reiniciar agente" ou qualquer tarefa de gerenciamento do ciclo de vida do agente.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Gerencie múltiplos agentes CLI locais via sessões tmux (iniciar/parar/monitorar/atribuir) com agendamento compatível com cron.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

See all skills by artubss

Report a problem with this skill