Referência

Referência de configurações

Todas as configurações de revisão, com seus valores e padrões. Defina os padrões da organização em Configurações da organização → Regras de revisão; um repositório pode substituir qualquer um deles em Repositórios → (um repositório) → Regras de revisão. Consulte Como funcionam as configurações.

Quando revisar

Configuração	Valores	Padrão
Frequência de revisão	Uma vez por PR, A cada push, Somente manual	Somente manual em um novo espaço de trabalho
Máximo de revisões automáticas por PR	1, 2, 3, 5, 10, 20, Sem limite. Só se aplica com A cada push.	5
Parar revisões automáticas quando um PR for fechado	Ativada, Desativada	Ativada
Filtros de revisão automática	Condições sobre Rótulos do PR, Autor, Equipe do autor, Vínculo do autor, Conta do autor, Estado do PR e Origem do PR. Um pull request precisa atender a todas elas.	Estado do PR Não é rascunho e Origem do PR Mesmo repositório

Como revisar

Configuração	Valores	Padrão
Profundidade de revisão padrão	Padrão, Profunda	Padrão
Revisar apenas as alterações novas	Ativada, Desativada	Ativada
Escopo do feedback	Conciso, Equilibrado, Detalhado	Equilibrado
Idioma da revisão	English, 简体中文, 日本語, Español, 한국어, Português (Brasil), Deutsch	English
Ler issues vinculadas	Ativada, Desativada	Ativada

Publicar resultados

Configuração	Valores	Padrão
Aprovação automática	Nunca aprovar automaticamente, Apenas alterações simples, Quando nenhum problema for encontrado	Nunca aprovar automaticamente
Publicar verificação do GitHub	Ativada, Desativada	Ativada
Reprovar a verificação quando forem encontrados problemas	Ativada, Desativada. Só se aplica enquanto Publicar verificação do GitHub estiver ativada.	Desativada
Publicar comentários de revisão no PR	Ativada, Desativada. Desativada também desliga a aprovação automática e a resolução de conversas.	Ativada
Marcar conversas atendidas do HeyDeer como resolvidas	Ativada, Desativada	Ativada

Acesso a revisões manuais

Configuração	Valores	Padrão
Quem pode iniciar revisões manuais	Qualquer pessoa com acesso de escrita ao repositório, ou Usuários ou equipes selecionados com acesso de escrita: até 100 nomes de usuário do GitHub e, em uma organização, até 30 slugs de equipe.	Qualquer pessoa com acesso de escrita ao repositório

As alterações valem para revisões solicitadas depois que você salva. As revisões na fila e em andamento mantêm as configurações delas.

Arquivos do repositório

O HeyDeer também lê estes arquivos do repositório em revisão.

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 é usado onde um diretório não tem AGENTS.md.
`.agents/checks/*.md`	A branch base	Um arquivo Markdown por verificação, diretamente em .agents/checks, com nome formado por letras, dígitos, pontos, sublinhados e hifens. Até 16.000 bytes cada, e até 10 verificações correspondentes por revisão, na ordem dos nomes de arquivo.
`.agents/skills/`	A versão do próprio pull request	Usada quando uma verificação a lista. O nome da pasta é o nome da skill: letras minúsculas, dígitos e hifens simples, até 64 caracteres.
`.gitattributes`	A branch base	Os arquivos marcados como linguist-generated ficam fora da revisão.

Frontmatter da verificação

Chaves opcionais de frontmatter YAML no início de uma verificação:

Chave	Valor	Efeito
`files`, `globs`, `paths`	Um padrão glob ou uma lista deles	Os arquivos alterados aos quais a verificação se aplica; use ! antes de um padrão para excluir arquivos. Sem padrões, a verificação se aplica a todos os arquivos alterados.
`skills`, `skill`	Um nome de skill ou uma lista deles	Skills que a verificação usa, carregadas do pull request. Uma skill ausente não interrompe a revisão.
`skip_extra_reviewers`	true ou false	As revisões profundas dedicam esforço extra a cada verificação correspondente. Defina como true em uma verificação simples para revisá-la como na profundidade Padrão.

Configurado no HeyDeer

Configuração	Onde	Regras e limites
Instruções de revisão	Configurações da organização → Instruções de revisão, ou Repositórios → (um repositório) → Instruções de revisão	Texto simples ou Markdown, até 12.000 caracteres por escopo. As instruções do repositório têm precedência em caso de conflito. Gerenciado pelos administradores do espaço de trabalho.
Servidores MCP	Configurações da organização → Servidores MCP, ou Repositórios → (um repositório) → Servidores MCP	Até 20 servidores por escopo, cada um sendo um servidor Streamable HTTP em um endpoint HTTPS público na porta 443. Os nomes usam letras minúsculas, dígitos, hifens e sublinhados, até 64 caracteres. Gerenciado pelos administradores do espaço de trabalho que também são proprietários da organização ou da conta no GitHub.