Issues
Tipos de issue
EpicBloque de trabajo grande; contiene historias
StoryFuncionalidad o requerimiento del usuario
TaskUnidad de trabajo (técnica o no técnica)
BugDefecto o comportamiento inesperado
Sub-taskHijo de historia/tarea; no puede existir solo
Campos de un issue
SummaryTítulo corto (obligatorio)
DescriptionDetalles, criterios de aceptación
AssigneePersona responsable
PriorityHighest / High / Medium / Low / Lowest
LabelsEtiquetas libres para agrupar
ComponentsSubsecciones del proyecto (p. ej., Backend, UI)
Fix VersionRelease al que apunta este issue
Story PointsEstimación de esfuerzo (Scrum)
Vínculos entre issues
blocks / is blocked byRelación de dependencia
clones / is cloned bySeguimiento de duplicados
relates toAsociación general
is caused by / causesRelación de causa raíz
Búsqueda JQL
Sintaxis básica
project = MYPROJ AND status = "In Progress" assignee = currentUser() AND resolution = Unresolved priority in (High, Highest) ORDER BY created DESC
Operadores
=Coincidencia exacta
!=No igual
in (a, b)Coincide con cualquiera de la lista
not in (a, b)Excluir lista
~ "text"Contiene (búsqueda de texto)
!~ "text"No contiene
is EMPTYEl campo no tiene valor
is not EMPTYEl campo tiene valor
> < >= <=Comparación (fechas, números)
Funciones de fecha
created >= -7d # last 7 days due <= endOfWeek() # due this week updated >= startOfMonth() # updated this month created >= "2025-01-01" # since specific date
Patrones JQL útiles
# Stale issues status != Done AND updated <= -30d # My open bugs assignee = currentUser() AND type = Bug AND resolution = Unresolved # Sprint scope sprint in openSprints() AND project = MYPROJ
Flujos de trabajo
Flujo de trabajo por defecto
To DoNo iniciado
In ProgressEn curso
DoneCompletado
Flujo de trabajo extendido
OpenCreado, en espera de clasificación
In ProgressEn trabajo activo
In ReviewRevisión de código o QA
DoneAceptado y cerrado
ReopenedVuelto desde Done
Conceptos del flujo de trabajo
StatusEstado actual de un issue
TransitionMovimiento permitido entre estados
ConditionQuién puede realizar una transición
ValidatorVerificaciones antes de ejecutar la transición
Post FunctionAcción tras la transición (p. ej., asignar)
ResolutionPor qué se cerró el issue (Fixed, Won't Do)
Tableros
Tipos de tablero
Scrum BoardBasado en sprints; backlog, planificación, velocidad
Kanban BoardFlujo continuo; límites WIP, sin sprints
Columnas del tablero
ColumnMapea uno o más estados
WIP LimitMáximo de issues en la columna (Kanban)
SwimlaneAgrupación horizontal (por épica, asignado, etc.)
Quick FilterFiltro de activación basado en JQL en el tablero
Configuración del tablero
FilterConsulta JQL que define el alcance del tablero
EstimationStory Points o Estimación original
Card LayoutCampos mostrados en las tarjetas de issue
Card ColorsColor por prioridad, asignado o consulta
Sprints
Ciclo de vida del sprint
CreateNombre + objetivo y fechas opcionales
PlanArrastrar issues del backlog al sprint
StartEstablecer duración (1-4 semanas típico)
ActiveEl equipo trabaja en los issues del sprint
CompleteMover items incompletos al backlog o siguiente sprint
Informes del sprint
Burndown ChartTrabajo restante vs tiempo
Sprint ReportCompletados vs no completados
Velocity ChartStory points por sprint a lo largo del tiempo
Cumulative FlowDistribución de estados a lo largo del tiempo
JQL de sprint
sprint in openSprints() # current sprint sprint in futureSprints() # upcoming sprints sprint = "Sprint 12" # specific sprint sprint in closedSprints() AND resolution = Unresolved
Filtros
Crear filtros
SearchEscribir JQL en la búsqueda de issues
Save AsGuardar JQL como filtro con nombre
StarMarcar un filtro para acceso rápido
SubscriptionEnviar resultados por email de forma programada
Compartir y permisos
PrivateSolo tú puedes ver el filtro
GroupCompartir con un grupo específico
ProjectCompartir con miembros del proyecto
PublicCualquier usuario autenticado
Edit PermissionsControlar quién puede modificar el filtro
Dashboards
Filter ResultsGadget que muestra issues de un filtro
Pie ChartDesglose por campo (prioridad, asignado)
Two DimensionalMatriz X/Y (p. ej., prioridad vs estado)
Activity StreamActividad reciente del proyecto
Atajos de teclado
Navegación global
g then dIr al dashboard
g then bIr al tablero
g then iIr a búsqueda de issues
/Búsqueda rápida
cCrear issue
?Mostrar atajos de teclado
Vista de issue
aAsignarme
mComentar
lEditar etiquetas
eEditar issue
j / kIssue siguiente / anterior en la lista
oAbrir issue seleccionado
Atajos del tablero
1-9Mover issue a la columna 1-9
tAlternar vista de detalle
nTarjeta siguiente
pTarjeta anterior
Patrones comunes
Plantilla de reporte de bug
Summary[Componente] Descripción breve del bug
Steps to ReproducePasos numerados para reproducir el issue
ExpectedQué debería ocurrir
ActualQué ocurre realmente
EnvironmentSO, navegador, versión, etc.
SeverityBlocker / Critical / Major / Minor / Trivial
Formato de historia
As a [role], I want [action], so that [benefit]. --- Acceptance Criteria: - [ ] Criterion 1 - [ ] Criterion 2
Operaciones masivas
Search → Select AllSeleccionar issues de los resultados de búsqueda
Bulk ChangeEditar, transicionar o eliminar en lote
CSV ExportExportar resultados para reportes
Board dragArrastrar issues entre columnas/sprints