proyecto propio · código abierto

Un bot que
corrige incidencias

issue-bot recibe por Telegram las incidencias de QA de un sitio WordPress local, acuerda un plan por chat, aplica la corrección con Claude Code y devuelve un informe de antes y después. Lo escribí entero yo.

github.com/Lacho00/issue-bot
issue-bot: bot de Telegram que corrige incidencias de QA con Claude Code
206pruebas automáticas
13pull requests fusionados
MITcódigo abierto
Qué es

Un bot de Telegram que lleva una incidencia de QA hasta el informe

Mi papel

Idea, diseño, código, pruebas y despliegue, yo solo

Estado

En uso diario sobre mis sitios locales de WordPress

Licencia

MIT, el código está en GitHub

// el bot, paso a paso

Una cara
para cada paso

La mascota es un robot con un bicho en la antena. Su expresión sigue el recorrido de una incidencia, y el informe dibuja la contenta, la preocupada o la neutral según el estado de las incidencias.

Mascota de issue-bot pensando, con burbujas sobre la cabeza
01 · detectaPensando
Mascota de issue-bot con gesto neutral
02 · planeaNeutral
Mascota de issue-bot con los ojos entornados, trabajando
03 · corrigeTrabajando
Mascota de issue-bot sonriendo, con la incidencia resuelta
04 · informaContenta
Mascota de issue-bot preocupada, con una incidencia pendiente
si queda algoPreocupada
// el problema

De QA
al informe

Un equipo de QA manda incidencias sueltas: capturas, textos reenviados, álbumes. Alguien tiene que averiguar de qué sitio hablan, abrir el código, proponer una corrección, aplicarla y demostrar que quedó bien.

issue-bot hace ese recorrido con una persona al mando. Reenvías los mensajes, aprueba el plan y recibes un informe con la captura de QA junto a la de Claude.

01

Detecta el sitio

Saca los dominios de las URL del mensaje y los busca en los .wp-create.json y en los vhosts de Apache. Si hay una sola coincidencia abre el trabajo; si hay varias o ninguna, pregunta con botones.

02

Acuerda un plan

Agrupa los mensajes en un lote que se cierra tras 2 minutos o con /plan. Claude lee el sitio, propone un plan y no toca nada hasta que pulsas Aprobar plan.

03

Corrige con Claude Code

Ejecuta Claude Code sin cabeza bajo una política estricta de permisos. No hace commit ni push: los cambios quedan en el árbol de trabajo para que los revises.

04

Informa antes y después

Genera un HTML con indicadores de estado y una tarjeta por incidencia, con la captura de QA y la de Claude lado a lado. Lo que escribas después es una corrección y abre otra ronda.

// seguridad

Control
antes que velocidad

El bot ejecuta Claude Code sobre los ficheros de tus sitios, movido por mensajes de Telegram. Lo traté como acceso remoto a esa máquina.

// lo que decide el hook
  • git commitdenegado
  • git pushdenegado
  • borrar en la base de datosdenegado
  • cambiar .claudedenegado
  • escribir en el sitiosandbox
  • red desde Bashsin red
  • escribir en fase de planninguna
Un solo dueñoignora a cualquier otro usuario y a cualquier otro chat; el primer mensaje registra al dueño
Hook antes de cada herramientaun PreToolUse deniega git commit, push, borrados de base de datos y cambios en .claude antes de cualquier regla de permiso
Bash en un sandboxbwrap sin red, con escritura solo en el sitio y en la carpeta del trabajo; en la fase de plan, en ninguna
Preguntar lo dudosolo que ninguna lista cubre sale con botones Permitir y Denegar, y la denegación siempre gana
Sin tocar producciónpensado para copias locales de desarrollo, no para sitios en producción
// en cifras

Números
del proyecto

206pruebas automáticas, todas en verde
13pull requests fusionados
2.829líneas de JavaScript en 22 módulos
MITlicencia abierta, el código completo está en GitHub

issue-bot es una herramienta personal, no un trabajo para un cliente: no hay resultados de negocio que contar. Las cifras salen del repositorio.

Node.js 22grammYClaude CodeTelegram Bot APIMCP SDKZodPlaywrightWP-CLIsystemdGitHub Actions
// tu proyecto

¿Tienes un proyecto en mente?

Cuéntame qué necesitas. Te respondo en menos de 24 h y, si encaja, recibes una propuesta cerrada por escrito.