O que Prompt Optimizer faz?
Analise um rascunho de prompt, critique-o, relacione-o aos componentes do ecossistema ECC e gere um prompt otimizado completo que o usuário possa copiar e executar.
Quando Usar
- O usuário diz "otimize este prompt", "melhore meu prompt", "reescreva este prompt"
- O usuário diz "ajude-me a escrever um prompt melhor para..."
- O usuário diz "qual a melhor forma de pedir ao Claude Code para..."
- O usuário diz "优化prompt", "改进prompt", "怎么写prompt", "帮我优化这个指令"
- O usuário cola um rascunho de prompt e pede feedback ou aprimoramento
- O usuário diz "não sei como criar um prompt para isso"
- O usuário diz "como devo usar ECC para..."
- O usuário invoca explicitamente
/prompt-optimize
Não Usar Quando
- O usuário quer a tarefa executada diretamente (apenas execute-a)
- O usuário diz "优化代码", "优化性能", "otimize este código", "otimize o desempenho" — são tarefas de refatoração, não otimização de prompt
- O usuário está perguntando sobre configuração do ECC (use
configure-eccem vez disso) - O usuário quer um inventário de skills (use
skill-stocktakeem vez disso) - O usuário diz "apenas faça" ou "直接做"
Como Funciona
Apenas consultivo — não execute a tarefa do usuário.
Não escreva código, crie arquivos, execute comandos ou tome qualquer ação de implementação. Sua ÚNICA saída é uma análise mais um prompt otimizado.
Se o usuário disser "apenas faça", "直接做" ou "não otimize, apenas execute", não mude para modo de implementação dentro desta skill. Diga ao usuário que esta skill apenas produz prompts otimizados e instrua-o a fazer uma solicitação de tarefa normal se desejar execução.
Execute este pipeline de 6 fases sequencialmente. Apresente os resultados usando o Formato de Saída abaixo.
Pipeline de Análise
Fase 0: Detecção de Projeto
Antes de analisar o prompt, detecte o contexto do projeto atual:
- Verifique se um arquivo
CLAUDE.mdexiste no diretório de trabalho — leia-o para obter as convenções do projeto - Detecte a stack tecnológica a partir dos arquivos do projeto:
package.json→ Node.js / TypeScript / React / Next.jsgo.mod→ Gopyproject.toml/requirements.txt→ PythonCargo.toml→ Rustbuild.gradle/pom.xml→ Java / Kotlin / Spring BootPackage.swift→ SwiftGemfile→ Rubycomposer.json→ PHP*.csproj/*.sln→ .NETMakefile/CMakeLists.txt→ C / C++cpanfile/Makefile.PL→ Perl
- Anote a stack tecnológica detectada para uso nas Fase 3 e Fase 4
Se nenhum arquivo de projeto for encontrado (por exemplo, o prompt é abstrato ou para um novo projeto), ignore a detecção e sinalize "stack tecnológica desconhecida" na Fase 4.
Fase 1: Detecção de Intenção
Classifique a tarefa do usuário em uma ou mais categorias:
| Categoria | Palavras-chave | Exemplo |
|---|---|---|
| Nova Funcionalidade | construir, criar, adicionar, implementar, 创建, 实现, 添加 | "Construir uma página de login" |
| Correção de Bug | corrigir, quebrado, não funciona, erro, 修复, 报错 | "Corrigir o fluxo de autenticação" |
| Refatoração | refatorar, limpar, reestruturar, 重构, 整理 | "Refatorar a camada de API" |
| Pesquisa | como, o que é, explorar, investigar, 怎么, 如何 | "Como adicionar SSO" |
| Testes | testar, cobertura, verificar, 测试, 覆盖率 | "Adicionar testes para o carrinho" |
| Revisão | revisar, auditar, verificar, 审查, 检查 | "Revisar meu PR" |
| Documentação | documentar, atualizar docs, 文档 | "Atualizar a documentação da API" |
| Infraestrutura | implantar, CI, docker, banco de dados, 部署, 数据库 | "Configurar pipeline CI/CD" |
| Design | projetar, arquitetura, planejar, 设计, 架构 | "Projetar o modelo de dados" |
Fase 2: Avaliação de Escopo
Se a Fase 0 detectou um projeto, use o tamanho do código como sinal. Caso contrário, estime a partir apenas da descrição do prompt e marque a estimativa como incerta.
| Escopo | Heurística | Orquestração |
|---|---|---|
| TRIVIAL | Arquivo único, < 50 linhas | Execução direta |
| BAIXO | Componente ou módulo único | Comando ou skill único |
| MÉDIO | Múltiplos componentes, mesmo domínio | Cadeia de comandos + /verify |
| ALTO | Cross-domínio, 5+ arquivos | /plan primeiro, depois execução em fases |
| ÉPICO | Múltiplas sessões, múltiplos PRs, mudança arquitetural | Usar skill blueprint para plano multi-sessão |
Fase 3: Correspondência de Componentes ECC
Mapeie intenção + escopo + stack tecnológica (da Fase 0) para componentes ECC específicos.
Por Tipo de Intenção
| Intenção | Comandos | Skills | Agentes |
|---|---|---|---|
| Nova Funcionalidade | /plan, /tdd, /code-review, /verify | tdd-workflow, verification-loop | planner, tdd-guide, code-reviewer |
| Correção de Bug | /tdd, /build-fix, /verify | tdd-workflow | tdd-guide, build-error-resolver |
| Refatoração | /refactor-clean, /code-review, /verify | verification-loop | refactor-cleaner, code-reviewer |
| Pesquisa | /plan | search-first, iterative-retrieval | — |
| Testes | /tdd, /e2e, /test-coverage | tdd-workflow, e2e-testing | tdd-guide, e2e-runner |
| Revisão | /code-review | security-review | code-reviewer, security-reviewer |
| Documentação | /update-docs, /update-codemaps | — | doc-updater |
| Infraestrutura | /plan, /verify | docker-patterns, deployment-patterns, database-migrations | architect |
| Design (MÉDIO-ALTO) | /plan | — | planner, architect |
| Design (ÉPICO) | — | blueprint (invocar como skill) | planner, architect |
Por Stack Tecnológica
| Stack Tecnológica | Skills a Adicionar | Agente |
|---|---|---|
| Python / Django | django-patterns, django-tdd, django-security, django-verification, python-patterns, python-testing | python-reviewer |
| Go | golang-patterns, golang-testing | go-reviewer, go-build-resolver |
| Spring Boot / Java | springboot-patterns, springboot-tdd, springboot-security, springboot-verification, java-coding-standards, jpa-patterns | code-reviewer |
| Kotlin / Android | kotlin-coroutines-flows, compose-multiplatform-patterns, android-clean-architecture | kotlin-reviewer |
| TypeScript / React | frontend-patterns, backend-patterns, coding-standards | code-reviewer |
| Swift / iOS | swiftui-patterns, swift-concurrency-6-2, swift-actor-persistence, swift-protocol-di-testing | code-reviewer |
| PostgreSQL | postgres-patterns, database-migrations | database-reviewer |
| Perl | perl-patterns, perl-testing, perl-security | code-reviewer |
| C++ | cpp-coding-standards, cpp-testing | code-reviewer |
| Outro / Não Listado | coding-standards (universal) | code-reviewer |
Fase 4: Detecção de Contexto Ausente
Varra o prompt em busca de informações críticas ausentes. Verifique cada item e marque se a Fase 0 o detectou automaticamente ou se o usuário deve fornecê-lo:
- Stack tecnológica — Detectada na Fase 0, ou o usuário precisa especificar?
- Escopo alvo — Arquivos, diretórios ou módulos mencionados?
- Critérios de aceitação — Como saber se a tarefa está concluída?
- Tratamento de erros — Casos de borda e modos de falha abordados?
- Requisitos de segurança — Autenticação, validação de entrada, segredos?
- Expectativas de teste — Unitário, integração, E2E?
- Restrições de desempenho — Carga, latência, limites de recursos?
- Requisitos de UI/UX — Especificações de design, responsivo, acessibilidade? (se frontend)
- Alterações no banco de dados — Schema, migrações, índices? (se camada de dados)
- Padrões existentes — Arquivos de referência ou convenções a seguir?
- Limites de escopo — O que NÃO fazer?
Se 3+ itens críticos estiverem ausentes, faça ao usuário até 3 perguntas de esclarecimento antes de gerar o prompt otimizado. Em seguida, incorpore as respostas no prompt otimizado.
Fase 5: Recomendação de Workflow e Modelo
Determine onde este prompt se situa no ciclo de vida de desenvolvimento:
Pesquisa → Planejar → Implementar (TDD) → Revisar → Verificar → Commitar
Para tarefas MÉDIAS+, sempre comece com /plan. Para tarefas ÉPICAS, use a skill blueprint.
Recomendação de modelo (incluir na saída):
| Escopo | Modelo Recomendado | Justificativa |
|---|---|---|
| TRIVIAL-BAIXO | Sonnet 4.6 | Rápido, custo-eficiente para tarefas simples |
| MÉDIO | Sonnet 4.6 | Melhor modelo de codificação para trabalho padrão |
| ALTO | Sonnet 4.6 (principal) + Opus 4.6 (planejamento) | Opus para arquitetura, Sonnet para implementação |
| ÉPICO | Opus 4.6 (blueprint) + Sonnet 4.6 (execução) | Raciocínio profundo para planejamento multi-sessão |
Divisão em múltiplos prompts (para escopo ALTO/ÉPICO):
Para tarefas que excedem uma única sessão, divida em prompts sequenciais:
- Prompt 1: Pesquisa + Planejar (use skill
search-first, depois/plan) - Prompt 2-N: Implementar uma fase por prompt (cada um termina com
/verify) - Prompt Final: Teste de integração +
/code-reviewem todas as fases - Use
/save-sessione/resume-sessionpara preservar contexto entre sessões
Formato de Saída
Apresente sua análise nesta estrutura exata. Responda no mesmo idioma da entrada do usuário.
Seção 1: Diagnóstico do Prompt
- Pontos Fortes: Liste o que o prompt original faz bem.
- Problemas:
Problema Impacto Correção Sugerida (problema) (consequência) (como corrigir) - Necessita Esclarecimento: Lista numerada de perguntas que o usuário deve responder. Se a Fase 0 detectou a resposta automaticamente, informe-a em vez de perguntar.
Seção 2: Componentes ECC Recomendados
| Tipo | Componente | Finalidade |
|---|---|---|
| Comando | /plan | Planejar arquitetura antes de codificar |
| Skill | tdd-workflow | Orientação de metodologia TDD |
| Agente | code-reviewer | Revisão pós-implementação |
| Modelo | Sonnet 4.6 | Recomendado para este escopo |
Seção 3: Prompt Otimizado — Versão Completa
Apresente o prompt otimizado completo dentro de um único bloco de código cercado por crases. O prompt deve ser autocontido e pronto para copiar e colar. Inclua:
- Descrição clara da tarefa com contexto
- Stack tecnológica (detectada ou especificada)
- Invocações de
/commandnos estágios corretos do workflow - Critérios de aceitação
- Etapas de verificação
- Limites de escopo (o que NÃO fazer)
Para itens que referenciam blueprint, escreva: "Use a skill blueprint para..." (não /blueprint, já que blueprint é uma skill, não um comando).
Seção 4: Prompt Otimizado — Versão Rápida
Uma versão compacta para usuários experientes de ECC. Varia por tipo de intenção:
| Intenção | Padrão Rápido |
|---|---|
| Nova Funcionalidade | /plan [funcionalidade]. /tdd para implementar. /code-review. /verify. |
| Correção de Bug | /tdd — escrever teste falho para [bug]. Corrigir até ficar verde. /verify. |
| Refatoração | /refactor-clean [escopo]. /code-review. /verify. |
| Pesquisa | Use a skill search-first para [tópico]. /plan com base nos resultados. |
| Testes | /tdd [módulo]. /e2e para fluxos críticos. /test-coverage. |
| Revisão | /code-review. Depois use o agente security-reviewer. |
| Documentação | /update-docs. /update-codemaps. |
| ÉPICO | Use a skill blueprint para "[objetivo]". Execute fases com verificações /verify. |
Seção 5: Justificativa dos Aprimoramentos
| Aprimoramento | Motivo |
|---|---|
| (o que foi adicionado) | (por que é importante) |
Exemplos
Exemplo 1: Prompt Vago em Chinês (Projeto Detectado)
Entrada do usuário: 帮我写一个用户登录页面
Fase 0 detecta: package.json com Next.js 15, TypeScript, Tailwind CSS
Prompt Otimizado (Completo):
Usar a stack tecnológica existente do projeto (Next.js 15 + TypeScript + Tailwind CSS) para implementar uma página de login do usuário.
Requisitos técnicos:
- Seguir a estrutura de componentes e as convenções de roteamento existentes do projeto
- Validação de formulário usando o esquema de validação já presente no projeto (verificar se já usa Zod/Yup/outro)
- Método de autenticação: usar o esquema de autenticação existente no projeto (se nenhum, padrão JWT)
- Incluir: formulário de login com email/senha, validação de formulário, mensagens de erro, estado de carregamento, layout responsivo
Workflow:
1. /plan planejar a estrutura de componentes e o fluxo de autenticação, referenciando o padrão de páginas existentes
2. /tdd testes primeiro: escrever testes unitários para o formulário de login e testes de integração para o fluxo de autenticação
3. Implementar a página de login e a lógica de autenticação
4. /code-review revisar a implementação
5. /verify verificar se todos os testes passam e a página renderiza corretamente
Requisitos de segurança:
- Senha não transmitida em texto claro
- Proteção contra força bruta (rate limiting)
- Proteção XSS
- Token CSRF
Critérios de aceitação:
- Todos os testes passam, cobertura 80%+
- Página renderiza corretamente em dispositivos móveis e desktop
- Login bem-sucedido redireciona para o dashboard, falha exibe mensagem de erro
Não fazer:
- Não implementar página de registro
- Não implementar funcionalidade de "esqueci a senha"
- Não alterar a estrutura de roteamento existente