Skip to main content
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 e como ela 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 dois 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 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:
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, 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

Não Faça: Muito Genérico

Evite Redundância Entre Prompts

Cada categoria 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

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:
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:
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:
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:
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:
Benefício: Formato de saída estruturado que o Gemini lida excepcionalmente bem, melhorando a qualidade das revisões.
Cenário: Deseja explicações detalhadas para problemas críticos, mas feedback conciso para problemas menoresPrompt de Sugestão Personalizado:
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:
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:
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:
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 os prompts de categoria
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 controlam o que Kody analisa em cada categoria de revisão. 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.