● Comunidad
netresearch
⚡ Instantáneo
jira-skill
por netresearch · netresearch/jira-skill
Dos habilidades (jira-communication + jira-syntax) que encapsulan las APIs de Jira Server/DC y Cloud a través de shell — problemas, JQL, sprints, registros de tiempo, adjuntos, sin necesidad de Docker.
Un paquete de habilidades de Claude Code para Jira sin dependencia de contenedor. jira-communication cubre operaciones API (obtener / actualizar / buscar por JQL / transicionar / comentar / vincular / registros de tiempo / adjuntar / gestión de tablero y sprint). jira-syntax ayuda con el marcado wiki de Jira. Funciona con Server/DC y Cloud mediante credenciales basadas en env, incluye un configurador interactivo jira-setup.py.
Por qué usarlo
Características clave
- Compatible con Jira Server, DC y Cloud
- Sin Docker — solo shell + Python
- Ciclo de vida completo del problema: crear, transicionar, comentar, vincular, registros de tiempo, adjuntar
- Ayudantes de búsqueda JQL
- Gestión de sprint y tablero
- Configurador interactivo de credenciales
jira-setup.py - Ayuda de jira-syntax para marcado wiki
Demo en vivo
Cómo se ve en la práctica
jira-skill.replay
▶ listo
Casos de uso
Usos del mundo real: jira-skill
Cuándo usarlo: A mitad del sprint cuando la velocidad está cayendo y sospechas que hay obstáculos.
Flujo
-
Listar problemas del sprint por estado
Usa jira-skill. Lista los problemas en el sprint 'Sprint 42' agrupados por estado. Marca cualquier cosa no actualizada en 3 días.✓ Copiado
→ Tabla agrupada con marcadores de estancamiento
-
Profundizar en obstáculos
Para los problemas bloqueados, obtén el último comentario y los problemas vinculados — ¿quién está esperando qué?✓ Copiado
→ Resumen de dependencias
-
Impulsar a los propietarios
Redacta un comentario en cada problema bloqueado etiquetando a la parte responsable.✓ Copiado
→ Borradores por problema
Resultado: Una lista clara de acciones de desbloqueo para impulsar en el stand-up.
Errores comunes
- Sobre-etiquetar — los comentarios cuestan atención — Deja que Claude redacte; publica manualmente solo los que importan
Cuándo usarlo: Cuando estás cortando un lanzamiento y necesitas notas orientadas al usuario a partir de la lista de problemas.
Flujo
-
JQL para el lanzamiento
JQL: fixVersion = 1.42 AND status = Done. Extrae resúmenes y tipos.✓ Copiado
→ Lista de problemas ordenada
-
Redactar notas
Agrupa por tipo (Función / Error / Mejora) y redacta notas de lanzamiento orientadas al usuario — sin jerga interna.✓ Copiado
→ Notas Markdown listas para publicar
Resultado: Notas de lanzamiento en minutos en lugar de horas.
Cuándo usarlo: Moviendo un lote de problemas entre estados (p. ej. deploy-complete).
Flujo
-
Ejecutar primero en seco
Encuentra todos los problemas 'En Staging' con fixVersion = 1.42. Aún no transiciones — solo lista.✓ Copiado
→ Lista para confirmar
-
Transición
Transiciona esos a 'Hecho' con un comentario 'Desplegado en producción en 1.42'.✓ Copiado
→ Resultado de transición por problema
Resultado: Estado de flujo de trabajo limpio, nada quedó en 'En Staging'.
Errores comunes
- Campos requeridos faltantes en la transición — La habilidad expone el campo requerido; suministralo en el prompt
Cuándo usarlo: Revisión de capacidad de fin de mes.
Flujo
-
Consultar registros de tiempo
Extrae todos los registros de tiempo para miembros del equipo en el proyecto ACME del mes pasado.✓ Copiado
→ Totales de horas por persona, por problema
-
Resumir
Resume a épica y comparte del total.✓ Copiado
→ Desglose de nivel superior
Resultado: Imagen de capacidad basada en trabajo realmente registrado.
Errores comunes
- Los registros de tiempo no están rellenos — datos malos — Marca a personas con 0 registros; no saques conclusiones de datos faltantes
Combinaciones
Combínalo con otros MCPs para multiplicar por 10
Vincular PRs a problemas de Jira o crear problemas de Jira a partir de errores de GitHub
Para cada problema de GitHub etiquetado como 'bug' abierto esta semana, crea un ticket de Jira en el proyecto ACME.✓ Copiado
Coste y límites
Lo que cuesta ejecutarlo
- Cuota de API
- Jira Cloud: típicamente 10 req/seg por usuario; Server/DC está configurado por instancia
- Tokens por llamada
- Bajo — principalmente respuestas API
- Monetario
- Habilidad gratuita; licencia de Jira por separado
- Consejo
- Usa filtros JQL del lado del servidor en lugar de extraer todo y filtrar del lado del cliente
Seguridad
Permisos, secretos, alcance
Ámbitos mínimos: Leer proyecto; escribir solo donde sea necesario (transición/comentario)
Almacenamiento de credenciales: JIRA_URL + JIRA_USER + JIRA_TOKEN en env; no registres en git
Salida de datos: Solo a tu host de Jira
No conceder nunca: Admin en la instancia
- Los tokens API para Cloud deben tener alcance de usuario; para Server/DC utiliza tokens de acceso personal, no contraseñas.
Resolución de problemas
Errores comunes y soluciones
401 No autorizado
Token faltante o revocado; ejecuta jira-setup.py de nuevo
Verificar: curl -u $JIRA_USER:$JIRA_TOKEN $JIRA_URL/rest/api/2/myself
400 en transición
La transición requiere un campo que no proporcionaste — inspecciona transiciones con get_transitions
La búsqueda devuelve 0 pero los problemas existen
Tu JQL o permisos del proyecto; verifica que el usuario pueda ver el proyecto
Alternativas
jira-skill vs otros
| Alternativa | Cuándo usarla | Contrapartida |
|---|
| MCP oficial de Atlassian | Prefieres integración de primer nivel | Menos control sobre el acceso a shell |