Cómo sincronizar story points con Jira

Puedes hacer planning poker directamente sobre tu backlog de Jira: importa los issues a una sala, estímalos en equipo, y haz que los story points aceptados se escriban de vuelta en cada issue automáticamente, sin copiar nada a mano. Esto elimina el paso lento y propenso a errores del final de la mayoría de las sesiones de estimación, en el que alguien escribe los números en los tickets uno por uno. A continuación: cómo conectar Jira, importar issues, estimar y enviar los puntos de vuelta, además de cómo estimar bien una vez configurado.

¿Todavía eligiendo una herramienta? Mira por qué los equipos usan planning poker para Jira sin instalar una app del Marketplace.

Lo que necesitas

• Un sitio Jira Cloud. (Jira Data Center no es compatible.)
• Una cuenta de Jira que pueda navegar el proyecto (para importar issues) y editar issues en él (para escribir la estimación de vuelta). Una cuenta compartida creada para esto, como [email protected], funciona mejor que la de una persona, ya que el token deja de funcionar cuando esa persona se va.
• El permiso para gestionar Planning Poker en tu organización, para conectar Jira. Los Owners lo tienen por defecto.

Paso 1: conecta Jira

1. Abre Configuración → Integraciones y elige Jira, luego Conectar.
2. Conéctate de la forma que prefieras:

• OAuth: se te redirige a Atlassian, apruebas el acceso y vuelves. No hay nada que copiar. Esta opción aparece cuando se ha configurado para tu workspace.
• Token de API: una clave de acceso personal. Completa tres campos: tu sitio de Jira (por ejemplo https://tu-equipo.atlassian.net), tu correo de la cuenta y el token de API. Creas el token en la propia página de Atlassian: id.atlassian.com → Security → API tokens → Create API token (el simple, no el "with scopes"). El token tiene los mismos permisos que la cuenta que lo creó. Paso a paso, con qué revisar si falla: conectar Jira con un token de API.

1. Usa Probar para comprobar la conexión. Tu clave se guarda de forma segura y nunca vuelve a mostrarse.

Paso 2: elige a dónde va la estimación

Justo después de conectar, un paso de Configurar pregunta si la estimación aceptada debe enviarse de vuelta a Jira, y a qué campo.

• Activa Enviar la estimación aceptada de vuelta.
• Elige el campo de Jira que guarda tus estimaciones. La lista muestra los campos numéricos de tu sitio, y Story point estimate ya aparece seleccionado cuando existe.
• Puedes cambiar esto más adelante en Configuración de estimación.

¿No sabes cuál de los dos campos de estimación de Jira elegir? La siguiente sección lo explica.

¿Story Points o Story point estimate? Qué campo elegir

Jira tiene dos campos de estimación que se parecen, y elegir el incorrecto es el motivo más común de que una estimación no aparezca en el tablero. Cuál necesitas depende del tipo de proyecto:

Dos cosas a tener en cuenta:

• Los boards personalizados se comportan como los company-managed. En un board personalizado, solo Story Points está disponible como estadística de estimación, incluso cuando el proyecto es team-managed. Atlassian recomienda usar el board que se creó junto con un proyecto team-managed.
• Cambiar un proyecto de tipo puede perder estimaciones. Al migrar un proyecto team-managed a company-managed, mantén marcada la opción "Retain" para que tus story points se mantengan.

Elijas el campo que elijas, asegúrate de que esté en la pantalla del issue en ese proyecto; de lo contrario, Jira rechaza la actualización.

Paso 3: trae los issues a una sala

1. Crea una sala (o abre una existente) y elige Importar en el panel de Tareas.
2. Elige Jira, luego tu proyecto.
3. Reduce la lista con los filtros: sprint, epic, tipo de issue y estado. También puedes buscar por texto.
4. Selecciona los issues que quieras, o todos, e impórtalos.

Los issues que ya están en la sala se marcan, así que nada se agrega dos veces. Cada tarea conserva su clave de Jira (como PROJ-142), un enlace de vuelta al issue y las primeras líneas de su descripción.

Paso 4: estima

Realiza la sesión como siempre: abre una tarea, todos votan, revelen, hablen de las diferencias, y acepten la estimación. Si eres nuevo en este ritual, nuestra guía paso a paso de planning poker recorre cada paso. Cuando aceptas la estimación, el número se escribe en el issue de Jira en cuestión de instantes, sin hacer esperar a la sala. El historial de la sala entonces muestra Estimación enviada, o el motivo por el que no pudo serlo.

Qué se envía y qué no

• Los números se envían. Los medios puntos también funcionan, ya que el campo de Jira es numérico.
• Las cartas ? y ☕ y los tamaños de camiseta no se envían, porque no son números. Quedan en el historial como "no enviado".

Si tu equipo estima en tamaños de camiseta, sigue usándolos en la sala, y escribe los story points en Jira a mano, o acuerden un deck numérico para las sesiones que alimentan Jira.

Estimar bien, con o sin Jira

• Estima antes del sprint, no durante. Mira los elementos del backlog que siguen en la fila, para que el sprint empiece con números que todos ya discutieron.
• Usa una sola escala y mantenla. Alternar entre Fibonacci y tamaños de una sesión a otra hace que tu historial sea imposible de comparar.
• Los puntos miden esfuerzo e incertidumbre, no tiempo. Evita traducirlos en horas. La velocidad de los sprints pasados te dirá cuántos puntos caben en el siguiente. Para saber qué son realmente los puntos, y qué no son, consulta qué son los story points.
• Vuelve a estimar cuando cambie el alcance. Una tarea que creció después de la discusión merece un nuevo voto.

Planning poker es una entre varias técnicas de estimación ágil, y es la que combina de forma más natural con escribir un único número acordado de vuelta en un tracker como Jira.

Si una estimación no se envió

• "El campo no está en la pantalla" o un error de permisos: verifica que el campo esté en la pantalla del issue en ese proyecto, y que la cuenta conectada pueda editarlo.
• La conexión dejó de funcionar: es posible que el token haya sido revocado o haya expirado. Usa Probar en la página de Integraciones, y Reconectar si hace falta.
• Algo no es un número: la carta ?, ☕ o un tamaño de camiseta. Esto es esperado.

Conectar lleva unos minutos, y a partir de ahí los números de tus sesiones caen en el lugar correcto sin que nadie los copie.

Preguntas frecuentes

¿Se puede hacer planning poker dentro de Jira?

Lo haces en una sala de planning poker conectada a Jira: importas los issues, los estimas en equipo, y los story points aceptados se escriben de vuelta en cada issue de Jira automáticamente, así que no hay que copiar nada a mano.

¿A qué campo de Jira van los story points?

Al campo numérico que elijas al conectar, normalmente Story point estimate. Ten en cuenta que Jira tiene dos campos parecidos, Story points y Story point estimate, así que elige el que muestra tu board y asegúrate de que esté en la pantalla del issue.

¿Funciona con Jira Data Center o Server?

No. La integración es compatible solo con Jira Cloud.

¿Necesito un token de API, o puedo usar OAuth?

Cualquiera de los dos. OAuth es una aprobación de un clic cuando está configurado para tu workspace. Un token de API es una clave personal que creas en Atlassian y pegas en tres campos. Ambos funcionan igual una vez conectados.

¿Qué pasa con los votos no numéricos como "?" o los tamaños de camiseta?

No se envían a Jira, porque el campo es numérico. Quedan en el historial de la sala marcados como "no enviado". Si estimas en tamaños de camiseta, agrega los puntos a Jira a mano o usa un deck numérico para las sesiones que alimentan Jira.

¿Puede todo el equipo estimar sin cuentas de Jira?

Sí. Solo la conexión usa una cuenta de Jira. Los compañeros se unen a la sala desde un enlace sin cuenta, y solo la estimación aceptada se escribe de vuelta en Jira.