Revisar una pull request
Iniciar una revisión desde un comentario de PR
- En un pull request abierto de GitHub o una solicitud de fusión de GitLab, publica un nuevo comentario:
/devin review. - Sigue el enlace de la respuesta de Devin. Lee la descripción general y, a continuación, abre un grupo de cambios relacionados para ver cómo encajan entre sí.
- En la barra lateral de análisis o en la vista Errores, selecciona un hallazgo y contrástalo con el código. Si necesitas más contexto, cítalo en el chat. Puedes corregir el código tú mismo o pedirle a Devin que haga una edición.
/devin review solicita un análisis. En cambio, un comentario como /devin fix the failing test le pide a una sesión de Devin que trabaje en el PR. Consulta Iniciar Devin desde un comentario de PR para GitHub e Iniciar Devin desde un comentario en una MR para GitLab.
Otras formas de abrir una revisión
- Desde Devin: Abre Devin Review y elige una PR que hayas creado, que se te haya asignado o cuya revisión se te haya solicitado. También puedes pegar la URL de una PR en el campo de enlace de PR, incluso para GitHub Enterprise o Azure DevOps. Para una PR de GitHub.com, puedes omitir
https://o usarowner/repo#123. - Desde GitHub.com: Reemplaza
github.compordevinreview.comen la URL de la PR. Puedes ver una PR pública sin tener una cuenta de Devin. Para una PR privada, inicia sesión con una cuenta que tenga acceso. - Desde una sesión de Devin: Selecciona Analyze en la card de la PR. Si la card ofrece tanto Analyze once como Analyze, elige Analyze once para una sola revisión. Analyze también habilita revisiones en los futuros pushes a esta PR.
Cmd o Ctrl pulsado, la PR se abre en una nueva pestaña del navegador.
En la lista, pulsa j o k para seleccionar la PR siguiente o anterior, o o l para abrirla en el panel, o Enter para abrir su página de revisión completa. Si la PR lo permite, a la aprueba y pasa a la siguiente, y m la fusiona o la agrega a la cola y pasa a la siguiente. Estos atajos de la lista son distintos de los atajos de la página de la PR.
Devin Review en acción
Lectura de una revisión
Empieza por la descripción general para ver qué comportamiento cambia el PR. En Guide view, lee el diff por grupos: un grupo puede reunir ediciones relacionadas de distintos archivos. Cuando Devin detecta código copiado o movido, muestra el movimiento en lugar de una eliminación seguida de una adición idéntica. Los hallazgos del capturador de errores aparecen en la barra lateral de análisis o en la vista Errores. Haz preguntas sobre el PR en el chat y obtén respuestas con contexto pertinente del resto de la base de código; también puedes preguntar a Devin directamente desde cualquier comentario, error o indicador en la vista de diff. En móvil, la revisión se abre en Changes. Cambia a Errores para ver errores, indicadores y hallazgos de seguridad, o usa Description, Discussion y Commits para consultar los demás detalles del PR. Cuando un enlace a un comentario o una revisión de GitHub se abre en Devin Review, la vista se desplaza hasta el elemento de destino y lo resalta. Esto también funciona en la pestaña de revisión dentro de una sesión de Devin, donde un enlace de GitHub a un archivo del diff del PR también se abre directamente en ese archivo. Cuando se suben commits después de la última revisión y ninguna regla los revisa, un banner Devin hasn’t analyzed the latest changes indica el último commit revisado y cuántos commits nuevos hay. Analyze latest ejecuta una revisión adicional del commit actual sin activar la auto-review; Analyze automatically la activa para este pull request, para todos los pull request que abras o, si puedes gestionar la configuración de revisión del repositorio, para todos los pull request del repositorio. En la pestaña de revisión dentro de una sesión de Devin, See changes muestra lo que se ha subido desde la última revisión. Cuando hay una revisión más reciente disponible, New commit cambia a un commit subido mientras la revisión estaba abierta, View latest commit cambia a un diff más reciente de un commit que Review ya conocía y New analysis actualiza el análisis sin cambiar el commit que se muestra.Navegar por los cambios y el historial de revisiones
- Marca los archivos como Viewed para hacer un seguimiento de tu progreso, o marca todos los archivos como vistos o no vistos desde la lista de archivos.
- Expande las líneas de contexto alrededor de un cambio, o usa Expand all lines en el encabezado de un archivo para mostrar el archivo completo y Collapse expanded lines para volver a contraerlo. Alterna un archivo Markdown entre su diff renderizado y su código fuente.
- Selecciona líneas del lado nuevo de un diff para usar Add to Chat, o elige Suggest change para abrir un comentario de revisión sobre esas líneas, rellenado previamente con un bloque de sugerencia que contiene su texto actual.
- Oculta los cambios que solo afectan a espacios en blanco para centrarte en las modificaciones sustanciales.
- Los recuentos de líneas del encabezado del PR y de la lista de Review excluyen de forma predeterminada las pruebas y el código generado. Pasa el cursor sobre un recuento para ver su desglose por categoría y elige ahí Relevant, Both o Full para cambiar el recuento que se muestra. Al hacer clic en el recuento, se alterna entre esas mismas tres vistas. Tu elección se aplica en ambos lugares.
- Pulsa
Cmd+FoCtrl+Fpara buscar en la revisión. El icono de filtro del campo de búsqueda ofrece Match case, Changed lines only y Skip collapsed files. De forma predeterminada, la búsqueda omite el contenido de los archivos contraídos, estén o no marcados como vistos. Los nombres de archivos y carpetas siguen apareciendo como coincidencias. - Usa Analysis history en el menú de acciones del encabezado para consultar un análisis anterior. En Select commits to view, puedes invertir el orden de los commits revisados. En GitHub, el selector también muestra las aprobaciones y las solicitudes de cambios asociadas a esos commits. Un enlace fijado a un commit anterior no muestra automáticamente los resultados más recientes; usa Switch to latest o Run analysis on latest cuando estén disponibles.
- Consulta la vista comprobaciones para ver el estado de la CI. En los proveedores compatibles, puedes gestionar revisores, etiquetas y personas asignadas sin salir de Review.
- El menú de configuración del diff incluye una opción Layout: File tree view muestra los diffs sin agrupar junto al árbol de archivos, y Guide view agrupa los cambios relacionados con explicaciones.
Archivos generados y límites de tamaño del diff
Los archivos marcados comolinguist-generated en el archivo .gitattributes de la raíz de tu repositorio Git no cuentan para el límite de tamaño del diff de Devin Review. La revisión muestra cuántas líneas se agregaron y eliminaron en ellos, pero no analiza sus cambios.
Devin Review lee .gitattributes desde el commit head del PR, por lo que una regla agregada en un PR se aplica a la revisión de ese mismo PR. Los revisores personalizados y Autoapprover solo respetan las reglas que ya existen en la base de fusión (el ancestro común que se usa para el diff del PR), así que un PR no puede excluir sus propios archivos de estas funciones. Por ejemplo, para marcar como generados los archivos de src/generated/, agrega esta regla al .gitattributes de la raíz:
Capturador de errores
El Capturador de errores analiza tu PR (pull request o solicitud de extracción) en busca de posibles problemas. Los hallazgos incluyen Errores, Indicadores y Seguridad. Los revisores personalizados, en beta, tienen sus propios hallazgos atribuidos. Si una sesión de Devin abrió el PR para corregir un hallazgo de análisis de código, la revisión integrada incluye una pestaña aparte, Hallazgo o Hallazgos, con esos hallazgos vinculados. Si tienes acceso a los hallazgos, esta pestaña aparece en el panel Revisión o Bandeja de entrada, así como en la pestaña PR de la sesión.Errores
Devin marca los posibles errores como bugs. Investiga primero los bugs graves, que se indican con un icono de bug rojo. Los bugs menos graves muestran un icono de advertencia naranja. Si está disponible, expande Learn more para ver el escenario de fallo y la corrección recomendada. El botón de copiar incluye la ubicación, la explicación y cualquier cambio sugerido.Indicadores
Un indicador Investigar plantea una duda sobre el código: revisa las líneas señaladas antes de decidir si hace falta una corrección. Un indicador Informativo explica un cambio sin pedirte que lo corrijas.Seguridad
Devin Review escanea vulnerabilidades de seguridad y las muestra junto con otros hallazgos. El análisis de seguridad forma parte de una revisión completa; usa la configuración de publicación para controlar si los hallazgos de seguridad se publican como comentarios en PR. Un análisis limitado al diff, como cuando la revisión automática queda en pausa por alcanzar un límite de gasto, no equivale a una revisión de seguridad completa. El escáner comprueba las siguientes categorías de vulnerabilidades:- Inyección (SQL, XSS, comandos, plantillas)
- Fallos de autenticación (control de acceso ausente o defectuoso, escalada de privilegios, bypass de autenticación)
- Exposición de secretos (claves codificadas, tokens en logs, credenciales en el código fuente)
- SSRF y path traversal
- Deserialización insegura, prototype pollution
- Falta de validación de datos de entrada no confiables
- Criptografía débil (algoritmos, gestión de claves)
- Seguridad del transporte/de las cookies (falta de aplicación de HTTPS, CORS permisivo, atributos de cookies inseguros)
- Valores predeterminados inseguros o configuraciones incorrectas introducidas por la PR
- Crítico — Vulnerabilidades detectadas con alta confianza que deben corregirse antes de fusionar
- Advertencia — Posibles debilidades de seguridad que vale la pena investigar
REVIEW.md para orientar lo que busca el escáner.
Cuando hay contexto disponible sobre el modelo de seguridad del repositorio, la revisión integrada y los revisores personalizados marcados como Security-related también leen SECURITY_MODEL.md, THREAT_MODEL.md y las secciones de SECURITY.md dedicadas al modelo de amenazas o de seguridad, ubicados en la raíz del repositorio.
¿Qué ocurre en el siguiente push?
Cuando Devin revisa un nuevo push en una PR que ya ha revisado, normalmente busca bugs introducidos o afectados por los cambios realizados desde la última revisión. Mantiene los hallazgos anteriores y comprueba si los nuevos commits los han corregido. Si los nuevos commits cambian sustancialmente lo que hace la PR, o si el nuevo diff es demasiado grande para una revisión incremental, Devin puede volver a revisar la PR completa. El límite de gasto de auto-review por PR se aplica al conjunto de las revisiones, no a cada push por separado. Al alcanzar ese límite, se pausan las futuras revisiones automáticas de la PR, pero no las revisiones manuales.Idioma de los comentarios de revisión
Puedes elegir el idioma que Devin Review usa para sus comentarios y análisis desde Configuración > Preferencias, en la sección Devin Review.- Seguir el idioma de la interfaz (predeterminado) — Los comentarios de revisión seguirán la configuración de idioma de tu interfaz.
- Un idioma específico — Elige un idioma en el menú desplegable Comment language para usarlo en los comentarios de revisión en lugar del idioma de tu interfaz.
Gestión de una revisión
Resolver hallazgos
La pestaña Errores agrupa los hallazgos según lo que queda por hacer con ellos:- Needs your attention: hallazgos abiertos pendientes de que los clasifiques.
- Devin is fixing: hallazgos en los que está trabajando la sesión de Devin de la PR. Consulta Corrección automática.
- Fixed: hallazgos que tú o Devin habéis cerrado como corregidos.
- Invalidated: hallazgos que tú o Devin habéis cerrado porque no requieren corrección.
Comentarios y revisiones
En GitHub, puedes dejar comentarios, aprobar la PR o solicitar cambios desde Devin Review. Para otros servicios de alojamiento, consulta la referencia de proveedores.Iniciar una revisión
Cuando escribes un comentario de nivel superior, un nuevo comentario inline o una respuesta a un hilo existente, el botón de envío ofrece dos acciones: Start a review agrupa tus comentarios en una revisión pendiente en lugar de publicarlos uno por uno, y Comment los publica de inmediato. Devin Review recuerda la última acción que elegiste y la establece como predeterminada, también para el atajo de tecladoCmd+Enter o Ctrl+Enter. Cuando hay una revisión en curso, el botón cambia a Add to review y los comentarios posteriores se suman a ella hasta que la envíes. Se trata de tu revisión para el autor, no de una solicitud de otro análisis de Devin.
Resolver comentarios
Resuelve un hilo de discusión cuando lo hayas atendido. En GitHub, Devin minimiza una revisión creada por un bot cuando todos sus hilos están resueltos y vuelve a mostrarla si se reabre algún hilo.Indicadores de propietarios de código
Un icono de escudo junto a un revisor en la barra lateral indica que se solicitó su revisión como propietario de código.Cambios de código desde el chat
Pide al agente del chat que haga cambios en el código. Revisa los cambios sugeridos y luego aplícalos como un commit en la rama del PR sin salir de Devin Review. Esto es distinto de la corrección automática, que usa una sesión de Devin para abordar los hallazgos.Acciones del flujo de trabajo del PR
Devin Review te permite realizar acciones en las PR directamente desde la página de revisión, sin tener que ir a GitHub.- Merge — Fusiona la PR con cualquier método de fusión que permita el repositorio (merge commit, squash o rebase). Si se permite más de uno, elígelo en el menú desplegable del botón de fusión; Devin Review recuerda en tu navegador tu última elección para ese repositorio y esa rama base. El botón de fusión refleja el estado actual de fusionabilidad de la PR y las comprobaciones obligatorias.
- Close — Cierra la PR sin fusionarla. Está disponible en el menú desplegable junto al botón de fusión.
- Convert to draft — Convierte una PR abierta en borrador. Está disponible en el menú desplegable cuando la PR está abierta y aún no es un borrador.
- Mark ready for review — Marca una PR en borrador como lista para revisión. En las PR en borrador, aparece un botón “Ready for review” en la barra de fusión; su menú también ofrece Review draft, que inicia una revisión sin marcar la PR como lista.
- fusión automática — Activa o desactiva la fusión automática de GitHub desde el menú desplegable del botón de fusión. Cuando está activada, la PR se fusionará automáticamente una vez que se completen todas las comprobaciones obligatorias. La barra de fusión muestra el estado actual de la fusión automática, incluida la persona que la activó.
Atajos de Teclado
m y n se ejecutan de inmediato, igual que los botones a los que equivalen, por lo que m fusiona sin pedir confirmación. Para cambiar una asociación de teclas, ve a Settings > Atajos de Teclado.
PR apiladas
Devin Review trata las PR apiladas como elementos de primera clase. Cuando una PR pertenece a una pila, la página de revisión muestra toda la serie y gestiona correctamente la fusión:- Panel de pila — El encabezado de la PR muestra la pila con todos sus integrantes ordenados de abajo arriba, hasta la rama base en la que se fusionan. Cada integrante enlaza a su propia página de revisión, por lo que puede revisar la pila capa por capa. La opción Invertir orden de la pila, junto al recuento de la pila, muestra primero la rama base, y su elección se guarda.
- Estado por capa — Cada integrante muestra un punto de estado que refleja si realmente se puede fusionar: verde cuando puede fusionarse (teniendo en cuenta la CI, las revisiones obligatorias y la protección de ramas), rojo si hay comprobaciones fallidas o conflictos, y naranja para cualquier otro impedimento para la fusión, incluso cuando una capa está lista por sí sola, pero está bloqueada por una PR no fusionable situada debajo. Un indicador agregado resume el estado de toda la pila.
- Diffs específicos — Cada PR de una pila se compara con la capa inferior, de modo que cada revisión, incluida la auto-review y el capturador de errores, solo ve el cambio de esa capa.
- Fusión de pila — Las PR apiladas se fusionan mediante la fusión atómica de pilas de GitHub: al fusionar una PR, también se fusionan todas las PR abiertas situadas debajo de ella en la pila, de abajo arriba, en una sola operación. El botón de fusión muestra exactamente cuántas PR incluirá la acción, y GitHub redirige las PR restantes a la rama base después.
- Fusión automática — Puede habilitar la fusión automática de GitHub en una PR apilada. Cuando la pila esté lista, GitHub fusionará la PR y todas las PR sin fusionar situadas debajo de ella.
Atribución de commits y comentarios
- Las detecciones de bugs, indicadores y anotaciones automatizadas siempre se muestran como Devin bot.
- Cuando un usuario escribe un comentario o una revisión a través de Devin Review, aparece bajo la identidad de GitHub del usuario.
- Cuando un usuario le pide al agente de chat que haga un cambio de código, el commit resultante se realiza como Devin bot.
- GitHub Suggested Changes sigue el comportamiento estándar de GitHub: cualquier revisor (incluido Devin) puede dejar una edición sugerida en un comentario de revisión. Aplicar una sugerencia es algo independiente de iniciar una sesión de corrección automática.
- Devin nunca creará commits ni comentarios en nombre de un usuario sin que el usuario inicie explícitamente la acción.
Corrección automática
La Corrección automática usa una sesión de Devin para resolver los hallazgos de la revisión en un PR. No es lo mismo que aplicar una edición sugerida concreta ni que pedirle al agente de chat de Review que prepare un commit.Cómo habilitarla
Para un PR que ya pertenece a una sesión de Devin, la corrección automática sigue la opción Automatically fix Devin Review findings: “Devin will automatically triage the findings and decide whether to fix, validate, or escalate them to you.” Esta opción tiene un valor predeterminado de la organización y una preferencia personal:- Para la organización: los administradores de la organización la activan o desactivan en Settings > Devin, en Pull requests. Como indica la fila, “This option configures the default for all users.” Los demás miembros no pueden cambiarla. En una cuenta Enterprise, cada organización tiene su propio valor predeterminado.
- Para ti: actívala o desactívala para los PR de tus propias sesiones en Configuración > Preferencias, en Devin sessions. El interruptor muestra el valor predeterminado de la organización hasta que lo cambies. Si tu preferencia difiere del valor predeterminado, aparece una etiqueta Reset to organization default, con una explicación al pasar el cursor por encima. Para volver a usar el valor de la organización, haz clic en ella o devuelve el interruptor a ese valor. Tu preferencia prevalece en ambos sentidos, incluso si la activas en una organización cuyo valor predeterminado está desactivado.
Corregir automáticamente con Devin también activa Automatically fix Devin Review findings
para ti si está desactivada.
Hallazgos en los PR del propio Devin
Si una sesión apta abrió el PR, recibe los nuevos hallazgos antes de que se publiquen individualmente. En GitHub:- El PR indica que Devin is fixing los hallazgos, y estos pasan a Devin is fixing en la pestaña Errores.
- Si Automatically fix Devin Review findings está activado para el propietario de la sesión y la monitorización del PR está activa, la sesión corrige lo que puede y registra una decisión para cada hallazgo.
- Devin publica una única revisión que indica lo que corrigió, con los detalles en Fixed by Devin. Los hallazgos que quedan pendientes para ti se publican como comentarios de revisión, según tu configuración de publicación. Los hallazgos que Devin invalidó no se publican.
Permisos y restricciones
- Para cambiar el valor predeterminado de la organización de Automatically fix Devin Review findings se necesitan permisos de administrador de la organización. La elección de cada miembro prevalece sobre el valor predeterminado en sus propias sesiones.
- Responding to bots, en Settings > Devin > Pull requests, sigue controlando los comentarios de otros bots, pero ya no controla la corrección automática.
- Los comentarios de resumen No Issues Found de Devin Review siempre se ignoran. Solo los comentarios con hallazgos reales activan corrección automática.
Si Automatically fix Devin Review findings está desactivado cuando Devin Review publica hallazgos, verás un aviso en la cronología de la sesión para habilitarlo.
Revisión Automática
Para revisar los PR de los que eres autor, usa tus preferencias personales. Para revisar los PR de tu equipo, agrega una regla en la configuración de revisión. En ambos casos, el repositorio debe estar conectado a Devin, aunque sea público.Las cuentas nuevas incluyen de forma predeterminada una regla para toda la cuenta que revisa los PR abiertos por sesiones
de Devin cuando están listos y en cada push, y Automatically fix Devin
Review findings está activado de forma predeterminada, de modo que esas sesiones corrigen los
hallazgos. Puedes editar o eliminar la regla en la configuración de revisión. Las cuentas
No Enterprise existentes con una sola organización recibieron la misma regla y
configuración, salvo que un administrador hubiera desactivado la configuración o eliminado la regla. En
el resto de organizaciones existentes, las reglas no cambian y la configuración
solo está activada donde Respuestas a bots ya permitía que Devin actuara sobre los comentarios
de Devin Review.
Modos de activación
Elige cuándo se inicia una regla:- PR is created — Cuando se abre el PR, incluso como borrador.
- PR is ready — Cuando el PR se abre ya listo o se marca como listo.
- Only once — Una sola revisión cuando se cumplen las condiciones de activación.
- Every push — Se vuelve a revisar en cada push posterior. Requiere el nivel completo de consumo por revisiones automáticas. Cuando se usan permisos de repositorio, una regla de repositorio ofrece Every push si alguna organización que te concede acceso de edición a ese repositorio también permite Every push, aunque estés consultando Settings desde otra organización. Consulta ¿Qué ocurre en el siguiente push? para saber qué abarca una revisión de seguimiento.
Autoinscripción (todos los usuarios)
Si la inscripción personal está habilitada para tu cuenta, los usuarios con una identidad de proveedor de Git vinculada y el nivel de consumo de Review adecuado pueden inscribirse por cuenta propia sin permisos de administrador.- Ve a Configuración > Preferencias.
- En Devin Review, establece Analysis trigger en Analyze PRs automatically when opened o Analyze PRs automatically when ready for review.
- Establece Analysis frequency en Only once o Every push, si tus permisos lo permiten.
Reglas de alcance limitado y exclusiones
Los administradores de revisiones configuran las reglas de revisión automática en la pestaña Review de Configuración > Revisión. La página también incluye las pestañas Seguridad, revisores personalizados, Autoapprover y facturación; la pestaña Seguridad se muestra a los administradores de revisiones de la cuenta. Abre el menú para agregar en Automatic analysis (Add repositories or users mientras la lista está vacía y Add repository después) y elige qué abarca la regla: Add GitHub organization, Add GitLab group, Add Azure DevOps project, Add Bitbucket workspace o Add Bitbucket project para todos los repositorios de ese espacio de nombres; Add single repository para un único repositorio; Add user para todas las PR que cree un miembro de la cuenta; o Add advanced rule para combinar condiciones. En el diálogo de la regla, elige un destino Repository u Organization y, a continuación, acótalo con condiciones:
is e is not comparan el texto exacto; elige matches o does not match para usar un patrón glob en las condiciones de repositorio, título, rama y archivo modificado. Después, elige el evento que inicia la regla y su frecuencia. El Esfuerzo de análisis de la regla puede usar el valor predeterminado de la cuenta o anularlo con Normal o Ultra.
En las reglas automáticas con una condición Originated by Devin, el nivel de consumo de la persona que inició la sesión de Devin limita cuándo puede coincidir esa condición. Un nivel que solo permite la creación admite la primera revisión válida, pero no las revisiones de pushes posteriores; un nivel solo manual o la falta del permiso de Review impiden que la condición coincida.
Usa exclusiones para las PR que la función no debe procesar. Las exclusiones que coinciden prevalecen sobre sus reglas de inscripción.
Cuando una exclusión impide la auto-review en una PR, expande Automatic analysis skipped by an exception para ver las reglas coincidentes a las que tienes acceso. Aun así, puedes ejecutar una revisión puntual; los pushes posteriores siguen excluidos.
La revisión automática, cada revisor personalizado y Autoapprover tienen reglas independientes. Habilitar la revisión automática estándar no habilita Autoapprover ni ningún revisor personalizado que no tenga una regla coincidente. Una exclusión de Autoapprover no deshabilita la revisión automática estándar.
Las reglas sustituyen a las anteriores listas de inscripción de repositorios y personales. Las antiguas entradas de inscripción legacy ya no inician revisiones; en su lugar, configura las reglas correspondientes.
En Git provider interaction, los administradores de revisiones de la cuenta también pueden desactivar Let Devin Review edit the PR description (activada de forma predeterminada), que agrega un enlace y el estado de la revisión a la descripción de la PR. Si está desactivada, tu descripción no se modifica y, en GitHub, el enlace y el estado aparecen en su lugar en un único comentario de la PR.
Publicar en GitHub
Los administradores de revisiones de la cuenta pueden configurar qué publica Devin en el proveedor de Git conectado desde Configuración > Revisión. La sección Post findings to, cuyo nombre corresponde a tus proveedores conectados, determina qué tipos de hallazgos se publican como comentarios: los bugs y los indicadores en la pestaña Review, y los hallazgos de seguridad en la pestaña Seguridad. Git provider interaction, en la pestaña Review, contiene los interruptores de la comprobación de CI y del enlace en la descripción de la PR:- Post CI check — Cuando está habilitado (de forma predeterminada), Devin crea un estado de commit
Devin Reviewen los proveedores compatibles para cada revisión. Passing condition determina cuándo se considera correcto: revisión completada (predeterminado), hilos resueltos o ningún hallazgo. En Azure DevOps, el estado se publica en el commit y en la propia pull request, por lo que aparece en la lista de estados de la pull request y puede exigirse mediante una política de rama Status (genredevin, nameDevin Review). Asigna como Authorized identity de la política la cuenta con la que publica Devin, para que ninguna otra identidad pueda satisfacerla. - Bugs — Publica bugs (errores probables o comportamiento incorrecto) como comentarios del PR.
- Seguridad — Publica vulnerabilidades de seguridad y sugerencias de fortalecimiento como comentarios del PR.
- Indicadores (investigate) — Publica indicadores de investigación (posibles problemas que vale la pena revisar más de cerca) como comentarios del PR.
- Indicadores (note) — Publica indicadores informativos (observaciones que pueden no requerir acción) como comentarios del PR.
Cuentas empresariales: La configuración se aplica a todas las organizaciones de la
cuenta Enterprise. Los controles de publicación de toda la cuenta requieren el permiso Manage
Review a nivel de cuenta; la gestión de reglas a nivel de organización no concede permiso para
cambiar estos valores predeterminados. La página de configuración de Review de cada organización abarca solo
los repositorios de esa organización y bloquea los ajustes definidos a nivel Enterprise,
marcados como Enterprise-level setting; para cambiarlos, ve a la configuración de Review
de la cuenta Enterprise.
Archivos de instrucciones
Devin Review respeta los archivos de instrucciones en tu repositorio. Si existe alguno de estos archivos, se usará como contexto al analizar tu PR:**/REVIEW.md**/AGENTS.md**/CLAUDE.md(sin distinguir entre mayúsculas y minúsculas)**/CONTRIBUTING.md(sin distinguir entre mayúsculas y minúsculas).cursorrules.windsurfrules.cursor/rules*.rules*.mdc.coderabbit.yaml/.coderabbit.ymlgreptile.json
.agents/, .devin/, agents/, .cursor/, .github/) se tratan como si pertenecieran al directorio principal a efectos del alcance. Por ejemplo, src/.agents/REVIEW.md se aplica a los archivos dentro de src/.
Estos archivos aportan contexto para una revisión. Si quieres una comprobación con nombre propio que informe de sus propios hallazgos, configura un revisor personalizado.
REVIEW.md
REVIEW.md es un archivo de instrucciones específico de Devin Review. Colócalo en cualquier lugar de tu repositorio para personalizar cómo Devin revisa los pull requests (PR) de tu proyecto. Devin detecta automáticamente los archivos REVIEW.md en cualquier nivel de directorio (**/REVIEW.md), por lo que puedes acotar las pautas de revisión a subdirectorios específicos si es necesario.
Usa REVIEW.md para definir pautas específicas de revisión, como:
- Áreas de la base de código que requieren una revisión más exhaustiva
- Errores comunes o anti-patrones a tener en cuenta
- Convenciones específicas del proyecto que quienes revisan deben hacer cumplir
- Archivos o directorios que se pueden omitir de forma segura durante la revisión
- Consideraciones de seguridad o rendimiento exclusivas de tu proyecto
REVIEW.md:
Reglas de revisión personalizadas
Puedes configurar archivos adicionales que se leerán como contexto de revisión en Context, dentro de Configuración > Revisión. Estos patrones de archivo son independientes de los revisores personalizados: aportan información de contexto, no definen un revisor que genere sus propios hallazgos. Para agregar archivos del repositorio:- Busca Context en la pestaña Review de la configuración de revisión.
- Selecciona Add context. Se abrirá directamente Add repository files o aparecerá un menú en el que puedes elegir Repository files.
- Introduce un patrón glob de archivos, como
docs/architecture/**/*.md, y agrégalo.
Instrucciones de contexto de revisión (Beta)
Las instrucciones escritas de contexto de revisión están en Beta y requieren acceso a la beta.
Los archivos de instrucciones del repositorio siguen disponibles de forma independiente.
- Abre Configuración > Revisión y busca Context.
- Abre el menú para agregar y elige Managed instructions, marcado como Beta.
- Introduce un título y las instrucciones de revisión.
- Elige All repositories o un ámbito de repositorios más limitado.
- Selecciona Add context.
Revisores personalizados (Beta)
Los revisores personalizados están en Beta. Si no puedes crear ni configurar un revisor, pídeselo a un Review manager de tu organización o cuenta.
Crear un revisor
- Abre Configuración > Revisión y selecciona la pestaña revisores personalizados.
- Selecciona Add reviewer e introduce un Name y, si quieres, una descripción.
- En Instructions, elige Plain text y describe qué debe comprobar y qué debe ignorar, o bien elige skill de repositorio o skill de organización (skill de Enterprise en una empresa) para basarte en una skill existente.
- Elige el valor de Finding urgency: Severe para problemas que deben corregirse, Moderate para indicadores que conviene investigar o Info para sugerencias y contexto.
- Selecciona Create and enable, o Save as draft para terminar más tarde.
- Abre el revisor y revisa Rules. Si puedes gestionar Review para toda la cuenta, los revisores nuevos tienen Run with Devin Review activado de forma predeterminada, por lo que participan en todas las revisiones. Para limitarlo a determinadas PR, desactiva esta opción y selecciona Add reviewer rule. En caso contrario, el revisor no tiene reglas al principio y debes agregar una para elegir qué PR comprueba.
Reutilizar una skill
Un revisor creado a partir de una skill de repositorio, una skill de organización o una skill de Enterprise tiene seleccionada de forma predeterminada la opción Keep the reviewer in sync with the skill: sus instrucciones son de solo lectura en el revisor y se actualizan cuando cambia la skill. Las skills de repositorio se leen desde la rama predeterminada del repositorio (normalmentemain o master).
Las skills de repositorio se ofrecen desde los directorios de skills del agente (como .agents/skills/ o .devin/skills/) y desde cualquier plugin del repositorio, usando los directorios que su .devin-plugin/plugin.json o .claude-plugin/plugin.json indique en skills o, en su defecto, su directorio skills/.
Si desmarcas la opción, el revisor conserva su texto actual y las actualizaciones de la skill quedan pendientes de tu aprobación. Para editar las instrucciones tú mismo, selecciona Change source… y cambia a Plain text. Así se desvincula el revisor de su skill y se conserva el texto actual.
En una empresa, los revisores se comparten. El texto de la skill de una organización,
incluidas sus futuras modificaciones, solo pueden leerlo los miembros de esa organización;
los demás Review managers pueden seguir editando el resto de la configuración del revisor.
Hallazgos y comprobaciones de CI
Los hallazgos incluyen el nombre del revisor y la urgencia configurada. View runs muestra el historial de ejecuciones de cada revisor con el número de hallazgos corregidos e ignorados, y permite filtrar las ejecuciones según el resultado de los hallazgos. Cada revisor tiene además una sección CI check. Su ajuste Post CI check determina si los hallazgos del revisor cuentan para la comprobación de Devin Review (Part of Devin Review) o si se publica una comprobación independiente (Separate check) con el nombre del revisor, comoDevin Review / API compatibility. La condición de aprobación (Passing condition) de una comprobación independiente puede ser:
- Reviewer finishes: basta con que el revisor termine, aunque haya encontrado problemas.
- All comments are resolved: se han resuelto todos los comentarios que publicó.
- There are no open findings: todos sus hallazgos están cerrados.
Límite de gasto
La sección Spend limit de cada revisor controla cuánto puede gastar en revisiones automáticas de un mismo PR. Budget ofrece dos opciones:- Part of Devin Review limit (predeterminado): el gasto del revisor se descuenta del límite de gasto de revisión automática por PR. Opcionalmente, puedes configurar Limit per pull request para fijarle al revisor un límite inferior a ese.
- Separate budget: el revisor gasta con cargo a su propio Limit per pull request, que es obligatorio, y sigue ejecutándose aunque se haya alcanzado el límite de Devin Review. Solo los Review managers a nivel de cuenta pueden elegir esta opción.
Historial de versiones y archivado
Selecciona Last updated on … en la página del revisor para abrir su historial de versiones. Ahí se muestran las 20 versiones más recientes de las instrucciones, cada una con los cambios respecto a la versión anterior. Restore guarda las instrucciones de una versión anterior como una versión nueva. Un revisor que sigue una skill no puede restaurar una versión anterior hasta que deje de seguirla. Deshabilita un revisor para detener sus próximas ejecuciones sin perder su configuración. Al archivarlo, se mueve a Archived reviewers, debajo de la lista de revisores, y se detienen sus ejecuciones; los hallazgos que ya publicó se conservan. Restore recupera un revisor archivado en estado deshabilitado, de modo que no vuelve a ejecutarse hasta que lo habilites.Autoapprover (Beta)
Autoapprover está en Beta y requiere acceso a la beta.
- Intención: ¿Se ajusta el cambio a la intención declarada por el autor del PR?
- Calidad del código: ¿Mantiene el cambio la base de código fácil de mantener y de revisar?
- Riesgo de incidente: ¿Podría un problema en el cambio provocar un incidente de fiabilidad o de seguridad?
Configurar Autoapprover
- Abre Configuración > Revisión y selecciona la pestaña Autoapprover. Si la pestaña indica que Autoapprover aún no está disponible para tu cuenta, significa que tu cuenta no tiene acceso a la beta.
- Agrega una regla de Autoapprover y selecciona el repositorio y las condiciones de PR que se evaluarán.
- Opcionalmente, agrega exclusiones de Autoapprover para los PR que nunca quieras que evalúe.
Instrucciones personalizadas opcionales
Para adaptar la rúbrica predeterminada, selecciona Add instructions en Instructions y elige dónde se aplican. Describe qué cambios puede aprobar tu equipo automáticamente y cuáles requieren siempre la revisión de una persona. En los criterios que abordan, estas instrucciones tienen precedencia sobre la rúbrica predeterminada; si varias instrucciones entran en conflicto, prevalece la de ámbito más específico. Autoapprover omite las instrucciones que no puede verificar, como una que dependa del estado de CI, y explica en el veredicto qué omitió. Cuando Autoapprover usa la rúbrica para evaluar un PR, también lee los archivosAPPROVAL_POLICY.md, y los archivos AUTOAPPROVE.md (el nombre anterior), de la raíz del repositorio y de los directorios de los archivos modificados y sus directorios padre. Autoapprover lee estos archivos desde la rama de destino del PR, por lo que un PR no puede definir sus propias reglas de aprobación, y proporciona el texto de los archivos al revisor como instrucciones. Un PR que modifique un archivo APPROVAL_POLICY.md o AUTOAPPROVE.md siempre requiere revisión humana.
Las instrucciones orientan las decisiones, pero no inscriben PR por sí solas. Por ejemplo, después de agregar una regla limitada a un repositorio de documentación, podrías agregar opcionalmente:
.github/ o los diff que superen un límite de tamaño. Mantén la protección de ramas y los controles de acceso.
Interpretar el resultado
La sección Autoapprover del PR muestra su resultado y su razonamiento:- Autoapproved: Devin aprobó el PR.
- Not autoapproved: el PR necesita revisión humana.
- Approved by a person: una persona ha dado su aprobación.
Permisos y coste
Permisos
El acceso a Devin Review se controla mediante los permisos de Devin Review del editor de roles. Los niveles de consumo distinguen entre revisión manual, revisión al crear una PR y revisión automática completa. Para configurar Devin Review en toda la cuenta se necesita el permiso Manage Review (que aparece como Manage Devin Review en algunos editores de roles); una concesión de permisos sobre un repositorio puede bastar para las reglas que abarca, como se describe a continuación. Los Admin de Enterprise pueden usar roles personalizados para restringir el consumo o conceder acceso a la configuración. Los permisos a nivel de cuenta rigen la configuración de toda la cuenta, mientras que los permisos de revisión a nivel de organización rigen el acceso dentro de las organizaciones de la empresa. Si se usan concesiones de permisos sobre repositorios, una concesión para configurar Review en un repositorio o una conexión Git también puede darte acceso a Configuración > Revisión para las reglas que abarca. La autoinscripción, si está habilitada, no requiere Manage Review, pero los modos de activación disponibles dependen de tu nivel de consumo. Consulta Roles a nivel de cuenta para ver la lista completa de niveles de permisos de Devin Review y lo que concede cada uno. Para gestionar las reglas de revisión automática y las exclusiones de una organización se necesita el permiso de organización Manage analysis rules, que el rol de organización integrado administrador de revisiones concede además de los permisos de miembro.Cuentas empresariales: Los administradores de revisiones de una organización pueden configurar los ámbitos
permitidos sin ser administradores de la organización principal. Los controles de toda la cuenta, como
los valores predeterminados de publicación y las instrucciones de contexto de revisión, siguen requiriendo
el permiso Manage Review a nivel de cuenta. La política de la empresa puede impedir las ediciones a nivel de organización.
Control de costes
Devin Review consume ACUs (unidades de cómputo del agente) del pool de ACU de tu empresa, el mismo pool que usan las sesiones de Devin y otros productos de Devin. Los Admin de Enterprise tienen varias herramientas para supervisar y controlar los costes de revisión.Los controles de organización y de consumo de Enterprise requieren una cuenta de Devin
Enterprise. Los límites de gasto por PR de la revisión automática también se aplican
a los planes basados en cuota. Para contratar un plan empresarial, contacta con ventas.
Panel de consumo
El panel de consumo empresarial en Settings > Consumption desglosa el uso de ACU por producto, e incluye una línea específica de Review en el gráfico de consumo diario. Los Administradores de la organización pueden ver el consumo de revisiones de su organización en Settings > Consumption Analytics. El panel incluye:- Desglose por usuario — Vea cuántos ACU de revisión consumió cada usuario en el ciclo de facturación actual y en el anterior.
- Desglose por repositorio — Vea el consumo de ACU de revisión, la cantidad de revisiones y la cantidad de bugs detectados por repositorio en el ciclo de facturación actual y en el anterior, lo que ayuda a identificar qué repos generan el mayor coste de revisión y dónde las revisiones detectan más problemas.
Indicador del tamaño de la revisión
Cada PR en Devin Review muestra una insignia de consumo con la talla de la revisión según el uso total de ACU en todos los jobs de revisión de ese PR:
Pasa el cursor sobre la insignia de tamaño para ver el total exacto de ACU, la cantidad de jobs de revisión ejecutados y el costo de la revisión que se está viendo actualmente. Esto ayuda a los revisores a comprender el impacto en el costo de volver a ejecutar revisiones o de habilitar revisión automática en PR con muchos cambios.
Límite de gasto de auto-review por PR
Los Admin pueden limitar cuánto gasta Devin Review en revisiones automáticas de una misma PR desde Configuración > Revisión, en la pestaña facturación, dentro de Límites de análisis automático. El límite se mide en ACU en los planes basados en ACU, o en dólares de gasto bajo demanda en los planes basados en cuota. Si dejas el campo vacío, se aplica el valor predeterminado gestionado por Cognition que se muestra en la configuración; no significa que no haya límite. Una vez que el gasto total en revisiones de una PR, sumando todos sus jobs de revisión, alcanza el límite, la auto-review se desactiva para esa PR y se omiten las futuras auto-reviews. Alcanzar el límite es un bloqueo flexible:- Las revisiones manuales siguen funcionando — el límite solo pausa las revisiones automáticas. Siempre puedes activar una revisión manualmente desde la página de revisión de la PR.
- Volver a habilitar por PR — Si vuelves a activar la auto-review desde el menú de acciones de la PR, se reanudan las revisiones y se añade una nueva asignación de presupuesto. El gasto registrado no se restablece, y las revisiones automáticas pueden volver a pausarse cuando se agote el nuevo presupuesto.
Esfuerzo de revisión y organización de facturación
La opción Esfuerzo de análisis de la configuración de revisión permite que un administrador de revisiones de la cuenta elija el esfuerzo predeterminado: Normal o Ultra. Normal prioriza la relación calidad-precio, mientras que Ultra realiza una revisión más exhaustiva con un coste mayor. Las cuentas empresariales también disponen del ajuste Organización de facturación predeterminada para el análisis automático en la pestaña facturación, que se aplica a las revisiones cuya organización de facturación no pueda resolverse de otro modo. Para modificarlo, se necesita el permiso de configuración de la cuenta. Si la atribución por organización está habilitada, la vista de consumo de revisiones puede mostrar a qué organización (o a la propia cuenta) se facturó la revisión más reciente. Cuando las reglas de facturación por repositorio están disponibles en la pestaña Facturación, los administradores de revisiones de la organización pueden editar las reglas de los repositorios delegados y cargar el coste de Review a una organización o un presupuesto aptos que gestionen. No pueden modificar una regla que ya cargue el coste a un pagador que no gestionen.Proveedores de Git Compatibles
dev.azure.com) y Azure DevOps Server 2020/2022. Conéctate mediante la integración de Azure DevOps, una entidad de servicio de Microsoft Entra o una colección de Azure DevOps Server con un token de acceso personal y, a continuación, inscribe los repositorios en la revisión automática desde Configuración > Revisión. Devin publica los hallazgos automatizados a través de la identidad de servicio conectada. Para comentar, responder, resolver hilos, votar en un PR o abandonar un PR con tu propia identidad, vincula tu cuenta personal de Azure DevOps a Devin. Las acciones atribuidas al usuario requieren una identidad delegada de Microsoft compatible, y un PAT de servidor compartido no la proporciona. Las ediciones del chat pueden aplicarse en un único commit, y las cuentas vinculadas pueden ver la lista de sus PR en Review. Las acciones de fusión y de borrador, así como la fusión automática, no están disponibles.
Bitbucket Data Center requiere la versión 8.16 o posterior, conectada mediante la integración de Bitbucket. Para comentar, agregar o quitar revisores, aprobar o rechazar un PR desde Devin Review, vincula tu cuenta de Bitbucket. La fusión, las etiquetas, las personas asignadas y las reacciones no están disponibles, y los cambios de código desde el chat se confirman archivo por archivo.
Bitbucket Cloud (bitbucket.org) es compatible mediante la integración de Bitbucket. Conecta tu workspace con un token de acceso o una cuenta de Devin dedicada vinculada mediante OAuth que administre los repositorios (Devin instala por sí mismo los webhooks que necesita la revisión automática) y, a continuación, agrega reglas de revisión automática desde Configuración > Revisión. Los comentarios, las respuestas y el rechazo de un PR desde Devin Review se publican en tu nombre, con tu propia cuenta de Bitbucket. No están disponibles la solicitud de revisores, la fusión, las acciones de borrador, la fusión automática, las etiquetas, las personas asignadas ni las reacciones. Los cambios de código desde el chat se confirman en un único commit.
Perforce Swarm admite el análisis de revisiones y los hallazgos automatizados a través de la identidad de servicio de la conexión. En este proveedor, la interfaz de usuario de Devin Review es de solo lectura para los comentarios humanos y las acciones de aprobación, y no puede aplicar ediciones del chat como commits. Las revisiones de Swarm no aparecen en la bandeja de entrada personal de PR. Las conexiones de Perforce solo están disponibles para determinadas cuentas.
