Referencia
Referencia de configuración
Todos los ajustes de revisión, con sus valores y su valor predeterminado. Configura los valores predeterminados de la organización en Configuración de la organización → Reglas de revisión; un repositorio puede anular cualquiera de ellos en Repositorios → (un repositorio) → Reglas de revisión. Consulta Cómo funciona la configuración.
Cuándo revisar
| Ajuste | Valores | Predeterminado |
|---|---|---|
| Frecuencia de revisión | Una vez por PR, En cada push, Solo manual | Solo manual en un espacio de trabajo nuevo |
| Máximo de revisiones automáticas por PR | 1, 2, 3, 5, 10, 20, Sin límite. Solo se aplica con “En cada push”. | 5 |
| Detener las revisiones automáticas cuando se cierre un PR | Activada, Desactivada | Activada |
| Filtros de revisión automática | Condiciones sobre Etiquetas del PR, Autor, Equipo del autor, Relación del autor, Cuenta del autor, Estado del PR y Origen del PR. Un pull request debe cumplirlas todas. | Estado del PR: No es borrador; Origen del PR: Mismo repositorio |
Cómo revisar
| Ajuste | Valores | Predeterminado |
|---|---|---|
| Profundidad de revisión predeterminada | Estándar, Profundo | Estándar |
| Revisar solo los cambios nuevos | Activada, Desactivada | Activada |
| Alcance de los comentarios | Conciso, Equilibrado, Detallado | Equilibrado |
| Idioma de la revisión | English, 简体中文, 日本語, Español, 한국어, Português (Brasil), Deutsch | English |
| Leer issues vinculados | Activada, Desactivada | Activada |
Publicar resultados
| Ajuste | Valores | Predeterminado |
|---|---|---|
| Aprobación automática | No aprobar automáticamente, Solo cambios sencillos, Cuando no se encuentre ningún problema | No aprobar automáticamente |
| Publicar comprobación de GitHub | Activada, Desactivada | Activada |
| Marcar la comprobación como fallida si se detectan problemas | Activada, Desactivada. Solo se aplica mientras “Publicar comprobación de GitHub” está activada. | Desactivada |
| Publicar comentarios de revisión en el PR | Activada, Desactivada. Desactivarla también desactiva la aprobación automática y la resolución de hilos. | Activada |
| Marcar como resueltos los hilos de HeyDeer atendidos | Activada, Desactivada | Activada |
Acceso a revisiones manuales
| Ajuste | Valores | Predeterminado |
|---|---|---|
| Quién puede iniciar revisiones manuales | Cualquiera con acceso de escritura al repositorio, o Usuarios o equipos seleccionados con acceso de escritura: hasta 100 nombres de usuario de GitHub y, en una organización, hasta 30 slugs de equipo. | Cualquiera con acceso de escritura al repositorio |
Los cambios se aplican a las revisiones solicitadas después de guardar. Las revisiones en cola y en curso conservan su configuración.
Archivos del repositorio
HeyDeer también lee estos archivos del repositorio que se revisa.
| Archivo | Se lee desde | Reglas y límites |
|---|---|---|
AGENTS.md, CLAUDE.md | La propia versión del pull request | Cualquier directorio. Se aplica a su directorio y a los que cuelgan de él; los archivos más profundos tienen prioridad. CLAUDE.md se usa donde un directorio no tiene AGENTS.md. |
.agents/checks/*.md | La rama base | Un archivo Markdown por comprobación, directamente en .agents/checks, con un nombre formado por letras, dígitos, puntos, guiones bajos y guiones. Hasta 16.000 bytes cada uno, y hasta 10 comprobaciones coincidentes por revisión, por orden de nombre de archivo. |
.agents/skills/ | La propia versión del pull request | Se usa cuando una comprobación la incluye. El nombre de la carpeta es el nombre de la skill: letras minúsculas, dígitos y guiones simples, hasta 64 caracteres. |
.gitattributes | La rama base | Los archivos marcados como linguist-generated se excluyen de la revisión. |
Frontmatter de las comprobaciones
Claves opcionales de frontmatter YAML al principio de una comprobación:
| Clave | Valor | Efecto |
|---|---|---|
files, globs, paths | Un patrón glob o una lista de patrones | Los archivos modificados a los que se aplica la comprobación; antepón ! a un patrón para excluir archivos. Sin patrones, la comprobación se aplica a todos los archivos modificados. |
skills, skill | Un nombre de skill o una lista de nombres | Skills que usa la comprobación, cargadas desde el pull request. Si falta una skill, la revisión no se detiene. |
skip_extra_reviewers | true o false | Las revisiones profundas dedican un esfuerzo adicional a cada comprobación aplicable. Establécelo en true en una comprobación sencilla para revisarla como en Estándar. |
Configurado en HeyDeer
| Configuración | Dónde | Reglas y límites |
|---|---|---|
| Instrucciones de revisión | Configuración de la organización → Instrucciones de revisión, o Repositorios → (un repositorio) → Instrucciones de revisión | Texto sin formato o Markdown, hasta 12.000 caracteres por ámbito. Las instrucciones del repositorio prevalecen en caso de conflicto. Las gestionan los administradores del espacio de trabajo. |
| Servidores MCP | Configuración de la organización → Servidores MCP, o Repositorios → (un repositorio) → Servidores MCP | Hasta 20 servidores por ámbito, cada uno un servidor Streamable HTTP en un punto final HTTPS público en el puerto 443. Los nombres usan letras minúsculas, dígitos, guiones y guiones bajos, hasta 64 caracteres. Los gestionan los administradores del espacio de trabajo que también son propietarios de la organización o la cuenta de GitHub. |