Pular para o conteúdo principal
Os Prompts Personalizados oferecem controle total sobre como Kody analisa seu código e comunica os achados. Adapte o que a IA busca em cada categoria de revisão, como ela classifica a severidade e como apresenta sugestões para corresponder aos padrões e ao estilo de comunicação da sua equipe.

Acessar Configurações de Prompts Personalizados

Configure seus prompts personalizados para todos os repositórios da sua organização

Por Que Usar Prompts Personalizados?

Padrões Específicos da Equipe

Alinhe as revisões de Kody com os padrões de codificação únicos, padrões arquiteturais e boas práticas da sua equipe

Otimização de Modelo

Crie prompts otimizados para os pontos fortes do seu modelo de IA específico ao usar BYOK

Controle de Foco

Direcione a atenção de Kody para os problemas mais relevantes para o seu projeto e reduza o ruído

Estilo de Comunicação

Personalize como Kody apresenta sugestões — detalhadas para problemas críticos ou concisas para problemas menores

Como os Prompts Personalizados Funcionam

Os Prompts Personalizados operam em três níveis:

Prompts de Categoria

Definem o que Kody busca em cada categoria de revisão:
Foco: Corretude do código e problemas de execuçãoCobertura padrão:
  • Falhas de execução (exceções não tratadas)
  • Resultados incorretos (saída errada)
  • Vazamentos de recursos (arquivos, conexões, memória)
  • Corrupção de estado (estados inválidos de objetos/dados)
  • Erros de lógica (fluxo de controle incorreto)
  • Condições de corrida (problemas de acesso concorrente)
Comprimento máximo: 2000 caracteres

Prompts de Severidade

Definem como Kody classifica a severidade dos problemas:
Definição: Problemas que exigem atenção imediataExemplos padrão:
  • Crash/indisponibilidade da aplicação
  • Perda/corrupção de dados
  • Violação de segurança (acesso não autorizado/exfiltração de dados)
  • Falha em operação crítica (autenticação/pagamento/autorização)
  • Operações com perda financeira direta
  • Vazamentos de memória causando crash inevitável
Comprimento máximo: 2000 caracteres

Prompts de Sugestão

Controlam como Kody comunica cada sugestão individual. Isso personaliza o formato e o tom da mensagem que aparece nos comentários do PR, como:
The new file 'create-or-update-issues-parameter.dto.ts' does not follow 
the company's naming convention. According to the Kody Rules, all new files 
must use camelCase. Please rename the file to 'createOrUpdateIssuesParameter.dto.ts' 
to adhere to the standard.
Seu prompt personalizado instrui Kody sobre como escrever mensagens de sugestão. O prompt recebe contexto sobre o nível de severidade, descrição do problema, código sugerido e se é uma violação de Kody Rules. Kody usa esse contexto junto com seu prompt para gerar mensagens apropriadas para cada sugestão. Você pode personalizar o tom, o nível de detalhe e o estilo de comunicação com base nas necessidades da sua equipe — desde explicações detalhadas para problemas críticos até feedback conciso para problemas menores.

Referências Externas

Todos os prompts personalizados — de Categoria, Severidade, Sugestão e Resumo de PR — suportam referências a arquivos reais das bases de código que Kody pode acessar. Quando você salva uma atualização, Kody detecta automaticamente as referências externas e as resolve para revisões futuras.
  • Use @file:caminho/para/arquivo.ts para apontar para arquivos no repositório que você está editando; Kody tentará localizar o caminho localmente primeiro.
  • Inclua @repo:org/projeto ao referenciar arquivos de outro repositório ou ao editar prompts no nível global.
  • Prefira caminhos precisos no estilo blob em vez de placeholders para que o modelo encontre o arquivo correto de forma confiável.
  • Após salvar, Kody processa as referências em segundo plano. Verifique o indicador de status ao lado do editor de prompts para confirmar quando a resolução for concluída.

Boas Práticas

Seja Específico ao Seu Contexto

Faça: Específico ao Contexto

Prompt de categoria Bug:
Foque em null pointer exceptions nos nossos
serviços Java, conexões de banco não fechadas
na camada DAO e condições de corrida nos nossos
handlers de eventos assíncronos. Verifique a
limpeza adequada de recursos em blocos try-finally.

Não Faça: Muito Genérico

Prompt de categoria Bug:
Procure bugs no código.
Verifique problemas e questões.

Evite Redundância Entre Prompts

Cada categoria e severidade deve ter um foco distinto. Não repita as mesmas instruções em diferentes prompts.
Categoria Bug: Foque na corretude da execução, null pointer exceptions e limpeza de recursos nos nossos serviços Java.Categoria Security: Foque em SQL injection, XSS e CSRF nos nossos endpoints de API. Verifique a sanitização de entrada e consultas parametrizadas.Categoria Performance: Foque em consultas N+1, índices de banco ausentes e loops ineficientes no processamento de dados.Resultado: Cada prompt tem um foco claro e sem sobreposição.
Categoria Bug: Verifique null pointers, SQL injection e consultas lentas.Categoria Security: Procure SQL injection, null pointers e problemas de performance.Categoria Performance: Encontre consultas lentas, null pointers e vulnerabilidades de segurança.Problema: Todos os prompts se sobrepõem, confundindo o modelo e reduzindo a qualidade da revisão.

Cuidado com Exemplos

Detecte SQL injection em consultas de banco:
- Concatenação de string bruta em instruções SQL
- Entrada do usuário diretamente em strings de consulta
- Ausência de consultas parametrizadas ou ORMs
- Construção dinâmica de consultas sem sanitização
Isso descreve o padrão de forma abrangente, capturando múltiplas variações.

Mantenha as Sugestões Escaneáveis

Para prompts de sugestão, torne as mensagens fáceis de escanear, já que os desenvolvedores revisam muitas de uma vez:
Escreva sugestões com estrutura clara. Para problemas críticos,
comece com o emoji 🚨, descreva o problema e mostre "Fix:"
seguido do código. Para outras severidades, mantenha simples —
apenas o problema e o código sugerido.

Coloque as informações importantes primeiro para que os
desenvolvedores entendam rapidamente o que precisa ser feito.
Hierarquia clara, informações importantes primeiro

Use o Contexto de Forma Significativa

Diferencie os formatos de sugestão apenas quando há uma razão real:
Para violações de Kody Rules, use um tom mais rígido:
"**Padrão da Equipe**: [problema]. Obrigatório: [código]"

Para sugestões padrão, use um tom mais amigável:
"[problema]. Sugerido: [código]"

A diferença na linguagem deixa claro o nível de obrigatoriedade.
Distinção clara: regras são requisitos, sugestões são recomendações

Casos de Uso

Cenário: Aplicação de saúde com requisitos de conformidade HIPAAPrompt de Security Personalizado:
Focus on HIPAA compliance in data handling:
- PHI (Protected Health Information) exposure in logs or errors
- Missing encryption for PHI at rest and in transit
- Inadequate access controls for patient data
- Audit logging gaps for PHI access
- Data retention violations
- Missing patient consent verification
Benefício: Kody captura problemas específicos de conformidade que revisões de segurança genéricas podem perder.
Cenário: Aplicação React/Node.js com padrões específicosPrompt de Bug Personalizado:
Focus on React and Node.js common pitfalls:
- Missing dependency arrays in useEffect/useMemo
- Unhandled promise rejections in async handlers
- Memory leaks from event listener cleanup
- Race conditions in state updates
- Missing error boundaries
- Uncaught exceptions in Express middleware
Benefício: As revisões são focadas nas armadilhas específicas da sua stack.
Cenário: Usando Gemini 2.5 Flash via BYOK para otimização de custosPrompt de Performance Personalizado:
Analyze algorithmic efficiency and resource usage.
List specific issues in this format:
1. Issue type and location
2. Current complexity
3. Optimization suggestion
4. Expected improvement

Prioritize: database queries, loops, memory allocations.
Benefício: Formato de saída estruturado que o Gemini lida excepcionalmente bem, melhorando a qualidade das revisões.
Cenário: Startup em ritmo acelerado, precisa de limites de severidade diferentesPrompt Critical Personalizado:
Only flag as Critical if:
- Production data could be deleted or corrupted
- Security breach allowing direct data exfiltration
- Payment processing failures
- Complete service outage for core features

Note: Performance issues are never Critical unless causing crashes.
Benefício: Reduz a fadiga de alertas ao alinhar a severidade com o impacto no negócio.
Cenário: Deseja explicações detalhadas para problemas críticos, mas feedback conciso para problemas menoresPrompt de Sugestão Personalizado:
When writing suggestions, adjust the level of detail based on severity:

For Critical issues: Start with "🚨 CRITICAL:" followed by the problem. 
Add a line explaining "This requires immediate attention." Then provide 
the fix with "Fix:" prefix.

For High severity: Use "⚠️" emoji, state the problem, then show the fix 
with "Fix:" prefix.

For Medium and Low: Keep it brief - just state the problem and show the 
suggested code directly without extra explanation.
Benefício: Problemas críticos recebem contexto extra enquanto problemas menores ficam concisos, melhorando a eficiência da revisão.
Cenário: A equipe prefere feedback mínimo e acionávelPrompt de Sugestão Personalizado:
Be direct and concise. State the problem in one sentence, then immediately 
show the fix with "Fix:" prefix. No additional context or explanations.
Benefício: Cada sugestão é curta e direta sem contexto extra.
Cenário: Desenvolvedores júnior se beneficiam de explicações detalhadasPrompt de Sugestão Personalizado:
Structure suggestions in three parts:

1. **Issue:** State the problem clearly
2. **Why this matters:** Explain the impact based on severity:
   - Critical: Could cause production failures or security vulnerabilities
   - High: May lead to bugs or performance problems  
   - Medium/Low: Improves code quality and maintainability
3. **Fix:** Show the recommended code change

Make explanations educational and help developers learn why it matters.
Benefício: Cada sugestão inclui contexto educacional sobre sua importância.
Cenário: Kody Rules são requisitos obrigatórios, sugestões são recomendaçõesPrompt de Sugestão Personalizado:
Use different tones based on the type:

For Kody Rules violations:
- Start with "**Team Standard Violation**" in bold
- State the problem
- Add "This violates documented team standards."
- Show "Required fix:" followed by the code

For standard suggestions:
- State the problem directly
- Show "Suggested improvement:" followed by the code
- Use a friendly, recommendatory tone
Benefício: Distinção clara entre regras obrigatórias e sugestões opcionais.

Solução de Problemas

Sintomas: Muitas sugestões de baixo valor após a personalizaçãoSoluções:
  • Torne os prompts mais específicos e focados
  • Adicione exclusões para padrões que você quer ignorar
  • Aumente o limiar mínimo de severidade em Controle de Sugestões
  • Verifique redundâncias entre prompts de categoria e severidade
Sintomas: Kody não captura problemas que deveriaSoluções:
  • Revise seu prompt para ver se está muito restrito ou muito específico em exemplos
  • Verifique se o problema se enquadra em uma categoria que você não personalizou
  • Tente redefinir para o padrão para ver se o problema é detectado
  • Considere se o problema pode ser classificado sob uma severidade diferente
Sintomas: O mesmo tipo de problema é sinalizado às vezes, mas não sempreSoluções:
  • Garanta que os prompts sejam claros e sem ambiguidades
  • Remova instruções conflitantes entre diferentes prompts
  • Verifique se está usando exemplos muito específicos
  • Considere se modelos diferentes no primário/fallback têm capacidades diferentes
Sintomas: Quer usar prompts personalizados, mas não sabe por onde começarSoluções:
  • Comece executando revisões padrão por uma semana
  • Anote padrões de falsos positivos ou problemas perdidos
  • Personalize apenas o prompt específico relacionado a esses padrões
  • Mantenha outros prompts no padrão até ver uma necessidade clara

Perguntas Frequentes

Depende de onde você os define:
  • Configurações globais: Aplicam-se a todos os repositórios da sua organização
  • Configurações por repositório: Sobrescrevem as configurações globais para aquele repositório específico
Isso permite ter padrões em toda a organização com sobrescritas específicas por repositório quando necessário.
Sim. Clique em qualquer prompt nas configurações para ver o conteúdo padrão.
As alterações afetam apenas novas revisões. Execute novamente com @kody start-review para aplicar novos prompts a PRs existentes.
Não. Os prompts personalizados são apenas via interface web para garantir alterações intencionais. Outras configurações (caminhos ignorados, branches) podem usar kodus-config.yml.
Personalize apenas prompts com necessidades claras e específicas. Mantenha os outros no padrão para se beneficiar das nossas melhorias. Comece com 1 a 2 prompts.
Funciona perfeitamente. Adapte os prompts aos pontos fortes do seu modelo. Tanto o primário quanto o fallback usam os mesmos prompts personalizados.
Prompts de Categoria/Severidade controlam o que Kody analisa e como classifica os problemas. Prompts de Sugestão controlam como Kody apresenta os achados para sua equipe. Você pode personalizar ambos de forma independente.
Sim. Os prompts de sugestão suportam formatação markdown padrão incluindo negrito, itálico, blocos de código e links.
Kody voltará ao formato de sugestão padrão e notificará você sobre o erro nas configurações.
Sim. Use a variável isKodyRule para criar mensagens diferentes para regras vs sugestões no mesmo prompt.