Ir al contenido

Clasificar tu bandeja de entrada

Esta guía te muestra cómo trabajar con la bandeja de entrada: la superficie que reúne en un solo lugar todo lo que te bloquea o te pide explícitamente a ti — aprobaciones de agentes pendientes, sincronizaciones de tickets fallidas y cada pull request en la que participas como revisor o autor.

  1. Haz clic en Bandeja de entrada en la barra lateral. Su insignia cuenta las aprobaciones de agentes pendientes, las sincronizaciones fallidas y las PR abiertas que esperan tu revisión.
  2. O presiona ⌘K y ejecuta el comando de navegación Bandeja de entrada.
  3. O abre directamente un enlace profundo a /workspaces/<workspace-id>/inbox.

La entrada de la barra lateral siempre muestra el conteo en vivo, así que puedes ver cómo se acumula el trabajo de clasificación sin abrir la página.

Recorre de arriba a abajo; la bandeja de entrada ya está ordenada por urgencia:

  1. La franja fijada Requiere tu atención está encima de las secciones de PR. Cada tarjeta lleva un chip de severidad. Las fuentes registradas (un agente atascado en una solicitud de confirmación, una sincronización de tickets cuyo espejo del proveedor está desactualizado) emiten Bloqueado.
  2. Dentro de la franja, la severidad más urgente va primero; en caso de empate, gana el elemento que lleva más tiempo esperando.
  3. Debajo de la franja, las PR se agrupan en secciones fijas del ciclo de vida de revisión — Esperan tu revisión, Devueltas a ti, Aprobadas, Borradores, Esperando revisores, Fusionándose y fusionadas recientemente, Esperando al autor. Las secciones de arriba son lo que te necesita a ti; el resto es donde están tus PR. Esperan tu revisión incluye las PR que aún solicitan un equipo al que perteneces en los hosts que los tienen (GitHub quita el equipo en cuanto algún compañero revisa).

Un elemento solo llega a la bandeja de entrada cuando bloquea algo o te solicita explícitamente. Una franja vacía más una lista de secciones vacía muestra Estás al día solo cuando ese vacío es confiable.

Una sola bandeja de entrada en todos los hosts de código

Sección titulada «Una sola bandeja de entrada en todos los hosts de código»

Si el espacio de trabajo tiene repos en más de un host de código, la bandeja de entrada los fusiona en un solo flujo: una pull request de GitHub y una de Bitbucket quedan en la misma sección, ordenadas por hora en lugar de agruparse por proveedor. El metadato repo #number de la fila es lo que permite distinguirlas.

«Tuyo» se resuelve por host, porque eres una cuenta distinta en cada uno. Una pull request solo cuenta como tuya, o como que solicita tu revisión, cuando coincide con tu identidad en el host donde realmente vive ese repo.

Un host caído o no conectado no aporta nada y deja intacto el resto de la bandeja de entrada: una conexión rota nunca vacía toda la lista. El estado vacío nombra una salvedad en lugar de Estás al día cuando todavía no se resuelve el inicio de sesión en ningún host (No se pudo confirmar tu cuenta de GitHub — el texto sigue nombrando a GitHub), cuando githubstatus.com reporta un incidente, o cuando está suspendida una instalación de GitHub App que cubre repos vinculados.

Cada tarjeta de la franja tiene una sola acción siguiente:

  1. Si una tarjeta es una confirmación pendiente de un agente, haz clic en Revisar: llegas al espacio de ese agente con su confirmación pendiente. Aprueba o rechaza ahí (consulta Chatear con un agente).
  2. Si una tarjeta dice Error de sincronización de un proveedor, haz clic en Abrir: llegas a Ajustes → Espacio de trabajo → General, cuya tarjeta Estado de sincronización muestra la última sincronización de cada conexión, su racha de fallas consecutivas y su resultado más reciente. En la bandeja de entrada solo aparece la última falla de cada proveedor, así que una sincronización recuperada limpia la tarjeta.
  3. Las tarjetas desaparecen solas una vez que se resuelve el estado subyacente (se responde al agente, se recupera la sincronización): no hay nada que descartar manualmente.
  1. Presiona f (sin ningún campo de texto enfocado) para abrir el menú de filtros, o haz clic en el botón de filtro de la barra de herramientas.
  2. Elige cualquier combinación de estado, autor, revisores, contenido, propietario/nombre del repo, ventanas de fechas o que sea rápida de revisar. Los conteos de facetas del menú muestran cuántos elementos de la bandeja coinciden con cada opción.
  3. Los filtros activos aparecen como chips en la barra sobre la lista; haz clic en la ✕ de un chip para quitar ese criterio.
  4. Usa el riel izquierdo para saltar entre secciones: cada entrada muestra su conteo en vivo y el resaltado sigue tu posición de desplazamiento. Haz clic en el encabezado de una sección para contraer las secciones que no clasificas (por ejemplo, Borradores mientras despejas revisiones).
  5. Haz clic en el encabezado de una columna (título, cambios o actualizado) para ordenar todas las secciones; haz clic otra vez en la columna activa para invertir la dirección. El botón de opciones de visualización controla la visibilidad de borradores, la ventana de fusionadas recientemente, las propiedades de fila, el orden y la agrupación (solo agrupar por autor cambia el diseño de la bandeja de entrada).

Los filtros de aquí son independientes de la cola de PR: acotar la bandeja de entrada nunca cambia los filtros de la cola, y viceversa.

  1. Haz clic en cualquier fila para abrir la página de detalle de la PR.
  2. Si la PR está en Esperan tu revisión, revísala y envía tu decisión; consulta Revisar y fusionar una PR.
  3. Si la PR está en Devueltas a ti (se solicitaron cambios o falló la CI), sube las correcciones desde tu checkout o delega el seguimiento a un agente.
  4. Si la PR está en Aprobadas, fusíonala desde la página de detalle.
  5. Si prefieres delegar una revisión en lugar de hacerla tú, consulta Despachar revisores y el ciclo de vida del despacho.

Cuando cambia el estado subyacente (tu revisión llega, la PR se fusiona), el clasificador vuelve a colocar la PR en su nueva sección automáticamente.

  1. Presiona ⌘Z para deshacer la última acción y ⌘⇧Z para rehacerla.
  2. Si hay un campo de texto enfocado, ⌘Z edita el texto del campo en su lugar: haz clic fuera del campo primero para deshacer una acción de la app.

Presiona ? (sin ningún campo de texto enfocado) para abrir la hoja de referencia de atajos de teclado. Enlista todos los atajos activos en la ruta actual, incluido el atajo de filtro f de la bandeja de entrada. El mapa completo está en la referencia de atajos de teclado.

  1. Presiona ⌘K en cualquier lugar para abrir la paleta de comandos.
  2. Escribe Bandeja de entrada para saltar a la página, o escribe el título de una PR: la paleta lista las pull requests que coinciden y abre la que elijas.
  3. Mientras la bandeja de entrada está abierta, ejecuta Copiar enlace de esta página para copiar esa URL y compartirla. El comando copia la ruta actual, así que es la URL de la bandeja de entrada solo cuando estás en esta página.

La bandeja de entrada se actualiza en vivo, pero si sospechas que los datos están desactualizados, haz clic en el control de actualización de la barra de herramientas: fuerza un barrido inmediato en el servidor de cada host conectado y vuelve a obtener las capas de fusionadas/revisadas. El icono gira hasta que se completa cada solicitud.