Equipos sin revisión de código
Usa esta configuración cuando los cambios llegan a main sin que nadie los lea, por ejemplo cuando los agentes hacen commit directamente en main o los pull requests se fusionan en cuanto pasa la CI. HeyDeer revisa cada push, y GitHub fusiona el pull request en cuanto HeyDeer lo aprueba.
Configuración recomendada
- Haz que los agentes suban su trabajo a una rama y abran un pull request para cada cambio, en lugar de hacer commit directamente en main.
- En Configuración del espacio de trabajo → Reglas de revisión → Cuándo revisar, selecciona En cada push. Consulta Revisiones automáticas.
- En Publicar resultados, activa Marcar la comprobación como fallida si se detectan problemas. Consulta La comprobación HeyDeer Review.
- En Publicar resultados, activa Aprobación automática. Así, HeyDeer aprueba un pull request cuando una revisión completa no deja ningún hallazgo. Consulta Aprobación automática.
- Decide quién aprueba los cambios de riesgo alto. De forma predeterminada, los pull requests de riesgo alto esperan a una persona. Para que HeyDeer también los apruebe, establece PR que HeyDeer puede aprobar en PR de cualquier nivel de riesgo.
- En las reglas de rama de main en GitHub, activa Require a pull request before merging con 1 aprobación requerida. Activa también Dismiss stale pull request approvals when new commits are pushed.
- En esas mismas reglas, exige la comprobación HeyDeer Review junto a tus comprobaciones de CI.
- Activa Allow auto-merge en la configuración de GitHub del repositorio. Después, activa la fusión automática (auto-merge) en cada pull request o haz que el agente ejecute
gh pr merge --auto --squashdespués de abrirlo.
Deja que el agente actúe sobre los hallazgos
HeyDeer publica sus hallazgos como una revisión en el pull request, y la comprobación HeyDeer Review contiene el informe completo. Haz que el agente lea la revisión después de cada push, corrija los hallazgos y vuelva a subir los cambios. Después, HeyDeer revisa los nuevos commits.
Para descartar un hallazgo, alguien con acceso de escritura explica la decisión en su conversación o resuelve la conversación, y después comenta @heydeer review. Consulta Descartar un hallazgo.
Si prefieres que HeyDeer corrija los hallazgos que elijas en un PR independiente, selecciona Corregir con HeyDeer en la revisión; consulta Corregir con HeyDeer.
Escribir tus estándares como comprobaciones
Los agentes cumplen un requisito con más fiabilidad cuando la revisión lo hace cumplir. Añade un archivo Markdown a .agents/checks/ por cada requisito, y HeyDeer lo aplicará a cada pull request que modifique los archivos coincidentes. Consulta Comprobaciones del repositorio.
.agents/checks/tenant-scope.md
---
files:
- "src/db/**/*.ts"
- "!**/*.test.ts"
---
Every query that reads or writes customer data must be
scoped to one tenant, taken from the request context and
never from request parameters.Por qué ayuda una revisión independiente
La CI solo detecta lo que cubren tus pruebas. Sin una revisión, se cuelan dos tipos de problemas:
- El modelo que escribió el código tiende a dar por bueno su propio razonamiento y a pasar por alto sus propios errores, incluso cuando le pides que revise su trabajo.
- Cuando un agente modifica el mismo código una y otra vez, cada cambio puede romper sin que nadie lo note algo que uno anterior había dejado bien.
HeyDeer revisa cada pull request por separado del agente que lo escribió y verifica cada hallazgo con el código antes de publicarlo. En los pushes posteriores, las revisiones de seguimiento vuelven a comprobar los problemas anteriores.