¿CON QUÉ IA?A quién le sirve. Equipos de software con documentación pública que se queda atrás cuando cambia el código.
Qué hicieron
Una tarea programada de Hermes se ejecuta los lunes a las 9. Con la herramienta gh lista las últimas 30 propuestas de cambio aceptadas en el repositorio hermes-agent, se queda con las de los últimos 7 días y comprueba si tocaron código de herramientas, comandos, configuración o variables de entorno. Para cada una comprueba si la página de documentación correspondiente cambió en la misma propuesta y manda un informe por Telegram.
Cómo salió
La fuente da una plantilla para copiar y no resultados medidos. El resultado es una lista de desajustes en los que cambió el código pero no la documentación. Si todo está al día, el agente responde [SILENT] y no se envía nada.
Conviene saber
La instrucción tiene escritas las rutas de archivos de ese repositorio y solo recupera 30 propuestas, así que adapta las rutas y sube el límite si en una semana se aceptan más de 30.
Qué necesitas
- Hermes Agent con tareas programadas.
- La herramienta de línea de comandos de GitHub (gh) con acceso de lectura a tu repositorio.
- La ruta de tu documentación dentro del repositorio.
- Telegram u otro canal donde recibir el informe.
Cómo hacerlo tú, paso a paso
- Instala Hermes Agent y la herramienta gh de GitHub, e inicia sesión con acceso de lectura a tu repositorio.
- Escribe la instrucción: lista las últimas propuestas de cambio aceptadas y quédate con las de los últimos siete días.
- Dile qué cambios afectan a la documentación, como herramientas, comandos, opciones de configuración o variables de entorno, y dónde están tus páginas de documentación.
- Pídele que compruebe, para cada una, si la página correspondiente cambió en la misma propuesta.
- Programa la tarea para el lunes por la mañana y haz que te mande el informe por Telegram.
- Si todo está al día, pídele que no mande nada.
Cada [día y hora], revisa las propuestas de cambio aceptadas en [nombre del repositorio] durante la última semana. Marca las que hayan cambiado [esquemas de herramientas, comandos, opciones de configuración o variables de entorno] y enumera qué páginas de documentación de [ruta de la documentación] probablemente haya que actualizar. Habrás terminado cuando me mandes un informe corto con los enlaces a las propuestas. No edites ninguna documentación.
Consejos
- La instrucción del autor tiene escritas las rutas de su propio repositorio. Cámbialas por las tuyas.
- Solo recupera 30 propuestas de cambio. Sube el límite si en tu equipo se aceptan más en una semana.
- Que solo avise. No le dejes editar la documentación.
Preguntas frecuentes
¿Qué es una tarea programada?
Una tarea que se ejecuta sola a una hora fijada, como un despertador. Aquí se lanza cada lunes a primera hora.
¿Sirve si mi documentación no está en GitHub?
La fuente solo lo cuenta con GitHub. Si tu documentación está en otro sitio, necesitas otra forma de saber qué ha cambiado en el código.
Fuentes
En el directorio desde el 3 de octubre de 2026.
@omx0r en X