gh-issues

• Tienes un backlog de issues de bugs con alcance bien definido y quieres un intento de corrección automatizado como primera pasada antes de la revisión humana.
• Ejecutas un pipeline de CI/cron programado y quieres que los issues sean clasificados y gestionados con PRs automáticamente sin intervención manual (modo --cron).
• Trabajas con un modelo de contribución basado en forks y necesitas que las ramas se envíen a tu fork con PRs dirigidos a un repositorio upstream (--fork).
• Quieres que los comentarios de revisión de PRs se aborden automáticamente — usa --reviews-only para que gh-issues analice los PRs abiertos fix/issue-* y envíe correcciones para los cambios solicitados.

• Los issues son vagos, arquitectónicos o de gran alcance — los sub-agentes de gh-issues se autoevalúan en términos de confianza y omitirán los issues que califiquen por debajo de 7/10, pero los issues muy complejos deben gestionarse manualmente.
• Necesitas corrección garantizada — los sub-agentes ejecutan pruebas cuando están disponibles, pero las correcciones generadas automáticamente deben revisarse antes de fusionarse en producción.
• No tienes un token de GitHub (GH_TOKEN) — gh-issues no puede autenticarse en ninguna API de GitHub sin él.

Hasta 8 sub-agentes se ejecutan de forma concurrente, cada uno abordando un problema de principio a fin: creación de rama, análisis de código, implementación de la corrección, ejecución de pruebas, commit, push y apertura de PR. Cada agente dispone de un presupuesto de 60 minutos y una verificación de confianza integrada: omite los problemas que no puede abordar con una confianza ≥7/10.

Después de que se abren los PRs, la Fase 6 obtiene revisiones, comentarios en línea, comentarios generales del PR e incluso revisiones de bots integrados (por ejemplo, Greptile). Los comentarios accionables activan sub-agentes adicionales que extraen la rama, aplican los cambios solicitados, envían una actualización y responden a cada comentario con el SHA del commit.

Pasa --fork user/repo para enviar todas las ramas a tu fork y abrir PRs desde el fork apuntando al repositorio fuente upstream — siguiendo el flujo de trabajo estándar de contribución de código abierto sin necesitar acceso de escritura al repositorio upstream.

--cron habilita la programación de tipo "disparar y olvidar": el orquestador selecciona un issue elegible, lanza un subagente y termina de inmediato — es seguro invocarlo desde un cron job cada pocos minutos. --watch mantiene el orquestador activo, consultando periódicamente nuevos issues y comentarios de revisión en un intervalo configurable.

Antes de iniciar, la habilidad gh-issues verifica la existencia de PRs abiertos, ramas en progreso en el repositorio de push y un archivo local de reclamaciones con vencimiento de 2 horas. Esto evita que sub-agentes duplicados compitan por el mismo issue durante ejecuciones de cron superpuestas o ciclos de monitoreo.

Pasa --notify-channel con un ID de canal de Telegram para recibir un mensaje de resumen final que contiene enlaces a PR y los resultados por issue. Solo se envía el resultado final, no las actualizaciones de estado intermedias.

Ejecuta /gh-issues owner/repo --label bug --limit 10 --cron desde un trabajo programado. Cada invocación selecciona el siguiente issue de error no reclamado, genera un sub-agente para implementar una corrección y finaliza. Con el tiempo, el backlog se va resolviendo de forma incremental sin intervención humana entre ejecuciones.

Usa /gh-issues upstream/project --fork myfork/project --label good-first-issue para que la skill obtenga los issues del repositorio upstream, envíe las ramas con correcciones a tu fork y abra PRs apuntando al proyecto upstream, respetando el flujo de trabajo estándar del colaborador.

Programa /gh-issues owner/repo --reviews-only --cron junto a tu pipeline de PRs existente. Cada ejecución analiza los PRs abiertos de fix/issue-* en busca de revisiones CHANGES_REQUESTED o comentarios en línea sin atender, selecciona el primer PR sin gestionar y lanza un agente para aplicar los cambios solicitados y responder.

Ejecuta /gh-issues owner/repo --label enhancement --watch --interval 10 durante una sesión de planificación de sprint. La skill obtiene los issues, te pide que confirmes cuáles procesar, genera agentes y consulta cada 10 minutos en busca de nuevos issues y comentarios de revisión — presentando resultados acumulados hasta que digas 'stop'.