Pular para o conteúdo principal
Uma diretiva de revisão permite dizer à Kody onde concentrar a análise mais profunda em uma revisão específica. Em vez de mudar qualquer configuração, você anexa uma instrução curta ao acionar a revisão — por exemplo, “foque na lógica de auth e sessão” — e a Kody gasta a análise mais rigorosa no código alterado que corresponde a isso.
Uma diretiva é efêmera: vale apenas para aquela execução de revisão. Ela não é salva nas suas configurações e não afeta revisões futuras. Para mudar o comportamento da Kody de forma permanente, use Custom Prompts ou Kody Rules.

​
Quando Usar

  • Um PR mexe em muitos arquivos, mas você se importa mais com uma área arriscada (auth, pagamentos, uma migração).
  • Você quer que a Kody rastreie os callers e callees de uma mudança específica e a questione com mais rigor.
  • Você está reexecutando uma revisão e quer direcionar a atenção sem editar nenhuma configuração.

​
Prioridade, Não Filtro

Este é o ponto mais importante de entender:
Uma diretiva define prioridade, não filtro. A Kody prioriza a área de foco, mas ainda reporta qualquer bug, problema de segurança ou de performance concreto que perceba em outros pontos do diff. Ela nunca suprime achados fora do foco e nunca aprova o resto do PR sem olhar.
Use uma diretiva para dizer “olhe aqui com mais afinco” — não “olhe só aqui.”

​
Como Acionar

Coloque o texto de foco logo após o comando de revisão em um comentário do pull request:
@kody review foque na lógica de auth e sessão
Você também pode usar start-review e combinar com --force:
@kody start-review foque na nova migração de banco de dados
@kody review --force foque no tratamento de erros do parser do webhook
Apenas a primeira linha após o comando é usada como diretiva. Tudo nas linhas seguintes é ignorado, então mantenha o foco em uma única linha.
Funciona no GitHub, GitLab, Azure DevOps, Bitbucket e Forgejo.

​
Escrevendo uma Boa Diretiva

  • Seja específico sobre a área, não sobre o veredito. “foque em concorrência no consumidor da fila” funciona melhor que “encontre bugs”.
  • Nomeie o código, não o resultado. Aponte para um módulo, fluxo ou preocupação (“a lógica de retry”, “o SQL no serviço de relatórios”).
  • Seja breve. Diretivas têm limite de 500 caracteres; só a primeira linha do comentário é lida.
  • @kody review foque no fluxo de autenticação e refresh de token
  • @kody review foque no novo tratamento do webhook do Stripe
  • kodus review --focus "condições de corrida no worker em background"
  • @kody review por favor seja minucioso — não há área para priorizar.
  • @kody review comente só no arquivo X — uma diretiva não é filtro; use caminhos ignorados para restringir arquivos.

​
Observações e Limites

  • Tamanho: diretivas são truncadas em 500 caracteres.
  • Só a primeira linha: em comentários de PR, apenas a primeira linha após o comando vira a diretiva.
  • Não confiável por design: como qualquer pessoa que pode comentar no PR pode fornecer uma diretiva, o texto é sanitizado antes do uso (caracteres de controle e sinais de menor/maior são removidos). Isso não altera o seu foco — apenas impede que o texto adultere o prompt interno da Kody.
  • Não persistida: nada é gravado nas configurações do seu repositório ou organização.