Acessar Configurações de Prompts Personalizados
Por Que Usar Prompts Personalizados?
Padrões Específicos da Equipe
Otimização de Modelo
Controle de Foco
Estilo de Comunicação
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:- Bug
- Security
- Performance
- 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)
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: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.tspara apontar para arquivos no repositório que você está editando; Kody tentará localizar o caminho localmente primeiro. - Inclua
@repo:org/projetoao 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.Exemplo: Separação Adequada
Exemplo: Separação Adequada
Anti-padrão: Prompts Redundantes
Anti-padrão: Prompts Redundantes
Cuidado com Exemplos
- Bom: Descrição de Padrão
- Arriscado: Exemplo Específico
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:- Bom: Estrutura Clara
- Ruim: Bloco de Texto
Use o Contexto de Forma Significativa
Diferencie os formatos de sugestão apenas quando há uma razão real:- Bom: Diferença Significativa
- Ruim: Rótulo Superficial
Casos de Uso
Requisitos Específicos de Setor
Requisitos Específicos de Setor
Otimização de Stack Tecnológica
Otimização de Stack Tecnológica
Ajuste Específico de Modelo
Ajuste Específico de Modelo
Comunicação Baseada em Severidade
Comunicação Baseada em Severidade
Feedback Direto e Conciso
Feedback Direto e Conciso
Sugestões Educativas
Sugestões Educativas
Tom Diferente para Regras vs Sugestões
Tom Diferente para Regras vs Sugestões
Solução de Problemas
Revisões Estão com Muito Ruído
Revisões Estão com Muito Ruído
- 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
Problemas Esperados Não São Encontrados
Problemas Esperados Não São Encontrados
- 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
Resultados Inconsistentes
Resultados Inconsistentes
- 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
Não Sabe o Que Personalizar
Não Sabe o Que Personalizar
- 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
Os prompts personalizados se aplicam a todos os repositórios?
Os prompts personalizados se aplicam a todos os repositórios?
- 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
Posso ver os prompts padrão antes de personalizar?
Posso ver os prompts padrão antes de personalizar?
O que acontece com PRs existentes quando eu altero os prompts?
O que acontece com PRs existentes quando eu altero os prompts?
@kody start-review para aplicar novos prompts a PRs existentes.Posso personalizar prompts com kodus-config.yml?
Posso personalizar prompts com kodus-config.yml?
kodus-config.yml.Devo personalizar todos os prompts ou apenas alguns?
Devo personalizar todos os prompts ou apenas alguns?
Como os prompts personalizados funcionam com BYOK?
Como os prompts personalizados funcionam com BYOK?
Qual é a diferença entre prompts de Categoria e prompts de Sugestão?
Qual é a diferença entre prompts de Categoria e prompts de Sugestão?
Posso usar markdown em prompts de sugestão?
Posso usar markdown em prompts de sugestão?
O que acontece se meu template de sugestão tiver erros de sintaxe?
O que acontece se meu template de sugestão tiver erros de sintaxe?
Os prompts de sugestão funcionam tanto para Kody Rules quanto para sugestões padrão?
Os prompts de sugestão funcionam tanto para Kody Rules quanto para sugestões padrão?
isKodyRule para criar mensagens diferentes para regras vs sugestões no mesmo prompt.