Personalize os prompts de revisão de Kody para cada categoria e nível de severidade de acordo com as necessidades da sua equipe
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
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.
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.
Prompt de categoria Bug:Foque em null pointer exceptions nos nossosserviços Java, conexões de banco não fechadasna camada DAO e condições de corrida nos nossoshandlers de eventos assíncronos. Verifique alimpeza 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.
Cada categoria e severidade deve ter um foco distinto. Não repita as mesmas instruções em diferentes prompts.
Exemplo: Separação Adequada
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.
Anti-padrão: Prompts Redundantes
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.
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.
Detecte SQL injection como este:query = "SELECT * FROM users WHERE id = " + userId
O modelo pode sinalizar apenas esse padrão exato e perder:
Template literals: SELECT * FROM users WHERE id = ${userId}
Formatação de string: f"SELECT * FROM users WHERE id = {userId}"
Para prompts de sugestão, torne as mensagens fáceis de escanear, já que os desenvolvedores revisam muitas de uma vez:
Bom: Estrutura Clara
Ruim: Bloco de Texto
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 osdesenvolvedores entendam rapidamente o que precisa ser feito.
Hierarquia clara, informações importantes primeiro
Explique o problema e por que é importante porque podecausar problemas em produção e os desenvolvedores devem corrigi-loaplicando as alterações de código sugeridas que resolverão o problema.
Diferencie os formatos de sugestão apenas quando há uma razão real:
Bom: Diferença Significativa
Ruim: Rótulo Superficial
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
Para Kody Rules, adicione o prefixo "[RULE]" antes do problema.Para sugestões, adicione o prefixo "[SUGGESTION]" antes do problema.Caso contrário, formate-os da mesma forma.
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.
Otimização de Stack Tecnológica
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.
Ajuste Específico de Modelo
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 location2. Current complexity3. Optimization suggestion4. Expected improvementPrioritize: database queries, loops, memory allocations.
Benefício: Formato de saída estruturado que o Gemini lida excepcionalmente bem, melhorando a qualidade das revisões.
Calibração de Severidade
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 featuresNote: 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.
Comunicação Baseada em Severidade
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.
Feedback Direto e Conciso
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.
Sugestões Educativas
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 clearly2. **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 maintainability3. **Fix:** Show the recommended code changeMake explanations educational and help developers learn why it matters.
Benefício: Cada sugestão inclui contexto educacional sobre sua importância.
Tom Diferente para Regras vs Sugestões
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 codeFor 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.
Os prompts personalizados se aplicam a todos os repositórios?
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.
Posso ver os prompts padrão antes de personalizar?
Sim. Clique em qualquer prompt nas configurações para ver o conteúdo padrão.
O que acontece com PRs existentes quando eu altero os prompts?
As alterações afetam apenas novas revisões. Execute novamente com @kody start-review para aplicar novos prompts a PRs existentes.
Posso personalizar prompts com kodus-config.yml?
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.
Devo personalizar todos os prompts ou apenas alguns?
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.
Como os prompts personalizados funcionam com BYOK?
Funciona perfeitamente. Adapte os prompts aos pontos fortes do seu modelo. Tanto o primário quanto o fallback usam os mesmos prompts personalizados.
Qual é a diferença entre prompts de Categoria/Severidade e prompts de Sugestão?
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.
Posso usar markdown em prompts de sugestão?
Sim. Os prompts de sugestão suportam formatação markdown padrão incluindo negrito, itálico, blocos de código e links.
O que acontece se meu template de sugestão tiver erros de sintaxe?
Kody voltará ao formato de sugestão padrão e notificará você sobre o erro nas configurações.
Os prompts de sugestão funcionam tanto para Kody Rules quanto para sugestões padrão?
Sim. Use a variável isKodyRule para criar mensagens diferentes para regras vs sugestões no mesmo prompt.