As cinco primeiras tabelas seguem as seções de Configurações do espaço de trabalho → Regras de revisão. Os padrões são os valores com que um novo espaço de trabalho começa, e cada configuração tem um link para a página que a explica. Um repositório segue o valor do espaço de trabalho até que você o personalize; consulte Como funcionam as configurações.
Quando revisar
| Configuração | Predefinição | O que faz |
|---|
| Frequência de revisão | Somente manual | Se o HeyDeer revisa pull requests por conta própria: Uma vez por PR, A cada push ou Somente manual. |
| Máximo de revisões automáticas por PR | 5 | Com A cada push, interrompe as revisões automáticas de um pull request depois deste número de revisões bem-sucedidas: 1, 2, 3, 5, 10, 20 ou Sem limite. |
| Parar revisões automáticas quando um PR for fechado | Ativada | Interrompe as revisões automáticas na fila e em execução quando um pull request é fechado ou mesclado. |
| Filtros de revisão automática | Estado do PR → Não é rascunho, Origem do PR → É qualquer um de → Mesmo repositório e Autor → Não é nenhum de → dependabot[bot], renovate[bot], pre-commit-ci[bot], snyk-io[bot], snyk-bot | Quais pull requests as revisões automáticas cobrem, por rótulos, autor, equipe, tipo de conta, estado de rascunho e origem. Um pull request precisa corresponder a todas as linhas. |
Como revisar
| Configuração | Predefinição | O que faz |
|---|
| Profundidade de revisão predefinida | Padrão | Padrão ou Profunda. Profunda dedica mais tempo a cada etapa, usa mais créditos e exige um plano pago. |
| Revisar apenas as alterações novas | Ativada | As revisões seguintes cobrem apenas o que mudou desde a última e verificam novamente as preocupações anteriores. |
| Escopo do feedback | Equilibrado | Quais problemas encontrados o HeyDeer relata, com base na confiança e na gravidade: Conciso, Equilibrado ou Detalhado. |
| Idioma da revisão | English | O idioma de tudo o que o HeyDeer publica no GitHub, incluindo os problemas encontrados, a verificação HeyDeer Review e as respostas a comandos: English, 简体中文, 日本語, Español, 한국어, Português (Brasil), Deutsch. O código e os caminhos de arquivo não mudam. |
| Ler issues e PRs relacionados | Ativada | Permite que o HeyDeer leia issues e pull requests do mesmo repositório que explicam a alteração. |
| Roteiro | Ativada | Adiciona um guia da alteração: agrupa as edições relacionadas e destaca as importantes. |
| Manter um snapshot do repositório | Ativada | As revisões de repositórios grandes começam mais rápido a partir de um snapshot da branch padrão. O snapshot é excluído um dia depois do último uso ou quando você desativa esta opção. |
Publicar resultados
| Configuração | Predefinição | O que faz |
|---|
| Aprovação automática | Desativada | Permite que o HeyDeer aprove pull requests que atendam às duas condições abaixo. Só funciona enquanto Publicar comentários de revisão no PR estiver ativado. |
| PRs que o HeyDeer pode aprovar | PRs de risco baixo e médio | O nível de risco mais alto que o HeyDeer aprova: PRs de risco baixo, PRs de risco baixo e médio ou PRs de qualquer nível de risco. |
| Problemas que podem permanecer | Nenhum problema pendente | Se o HeyDeer pode aprovar enquanto restam problemas encontrados ou preocupações anteriores de gravidade baixa: Nenhum problema pendente ou Permitir problemas de gravidade baixa. |
| Publicar verificação do GitHub | Ativada | Mostra o progresso e os resultados da revisão na verificação HeyDeer Review. |
| Reprovar a verificação quando forem encontrados problemas | Desativada | Reprova a verificação por problemas encontrados, preocupações anteriores em aberto ou não confirmadas e revisões incompletas. Só vale enquanto Publicar verificação do GitHub estiver ativado. |
| Publicar comentários de revisão no PR | Ativada | Publica cada revisão no pull request. Desativar também desliga a aprovação automática e a resolução de conversas. |
| Marcar conversas atendidas do HeyDeer como resolvidas | Ativada | Resolve as conversas do HeyDeer quando uma revisão posterior constata que a preocupação foi corrigida ou aceita uma decisão de não agir. |
Autopilot
| Configuração | Predefinição | O que faz |
|---|
| Máximo de rodadas por execução | 5 | Interrompe uma execução do Autopilot depois desse número de rodadas: 3, 5, 8, 10, 12 ou 15. |
Acesso a revisões manuais
| Configuração | Predefinição | O que faz |
|---|
| Quem pode solicitar revisões | Qualquer pessoa com acesso de escrita ao repositório | Quem pode solicitar revisões ao HeyDeer, em comentários do PR ou na verificação. A outra opção, Usuários ou equipes selecionados com acesso de escrita, aceita até 100 nomes de usuário e, em organizações, 30 equipes. |
Configurado no HeyDeer
Uma revisão usa as regras de revisão, as instruções e os conectores salvos quando o HeyDeer a coloca na fila. Um pull request não pode alterá-los.
| Configuração | Onde | Quem pode alterar | Regras e limites |
|---|
| Regras de revisão | Configurações do espaço de trabalho → Regras de revisão, ou Repositórios → (um repositório) → Regras de revisão | Administradores do espaço de trabalho | Um repositório segue cada padrão do espaço de trabalho até que você o personalize. |
| Instruções de revisão | Configurações do espaço de trabalho → Instruções de revisão, ou Repositórios → (um repositório) → Instruções de revisão | Administradores do espaço de trabalho | Texto simples ou Markdown, com até 12.000 caracteres em cada nível. As instruções do repositório têm precedência em caso de conflito. |
| Conectores | Configurações do espaço de trabalho → Conectores | Administradores do espaço de trabalho que também são proprietários da organização ou da conta no GitHub | Os conectores estão incluídos nos planos pagos. Até 50 por espaço de trabalho; cada um precisa ser um servidor Streamable HTTP em um endpoint HTTPS público. |
Os administradores só podem alterar as configurações de um repositório se tiverem acesso a ele no GitHub. Consulte Membros do espaço de trabalho.
Arquivos do repositório
O HeyDeer também lê estes arquivos do repositório em revisão. Qualquer pessoa que possa fazer push na branch de um pull request pode alterar os arquivos lidos dela; consulte O que um pull request pode alterar.
| Arquivo | Lido de | Regras e limites |
|---|
AGENTS.md, CLAUDE.md | A versão do próprio pull request | Qualquer diretório. Vale para o próprio diretório e os subdiretórios; arquivos mais profundos têm precedência. O CLAUDE.md é lido quando um diretório não tem AGENTS.md. Até 32 KiB no total, da raiz até um diretório; o restante fica de fora. |
REVIEW.md | A versão do próprio pull request | Qualquer diretório. Vale para as alterações no próprio diretório e nos subdiretórios; arquivos mais profundos têm precedência. Um link simbólico não é lido. |
.agents/checks/*.md | A versão do próprio pull request | Um arquivo Markdown por verificação, diretamente em .agents/checks, com files no frontmatter. Os nomes começam com uma letra ou um dígito e usam letras, dígitos, ., _ e -. Até 16.000 bytes por arquivo. Uma revisão executa no máximo 10 verificações correspondentes, na ordem dos nomes de arquivo. |
.agents/skills/ | A versão do próprio pull request | Usada quando uma verificação a lista. Cada skill é uma pasta com um SKILL.md, nomeada com letras minúsculas, dígitos e hifens simples, com até 64 caracteres. |
.gitattributes | A branch base | Os arquivos marcados como linguist-generated, e os lockfiles que ela já tem, a menos que estejam marcados como -linguist-generated, ficam fora da revisão. Qualquer pessoa que possa fazer merge na branch base pode alterar esse arquivo. |
Frontmatter da verificação
Toda verificação começa com um frontmatter YAML entre duas linhas ---. O HeyDeer ignora as demais chaves.
| Chave | Valor | Efeito |
|---|
files | Um padrão ou uma lista de padrões | Obrigatório; sem essa chave, o HeyDeer ignora o arquivo. Os arquivos alterados cobertos pela verificação. Adicione ! antes de um padrão para excluir arquivos; as exclusões exigem pelo menos um padrão de inclusão. |
skills | Um nome de skill ou uma lista de nomes | Opcional. Skills que a verificação usa, carregadas do pull request. Uma skill ausente não interrompe a revisão. |
