miyagi v0.11.0

miyagi trabaja ya en Moodle sin navegador propio, guarda tus asignaturas por su nombre, admite extensiones y aprende tu normativa. La guía completa está en https://falkenslab.github.io/miyagi/.

Instalar o actualizar

npm install -g https://github.com/falkenslab/miyagi/releases/latest/download/miyagi.tgz

Novedades

• El aula, cuando tú quieras. Puedes trabajar una asignatura sin Moodle (la programación, los temas, los materiales) y conectar el aula más tarde con miyagi init.
• Moodle con moodle-teacher, sin navegador propio. miyagi trabaja en tu curso con las herramientas fijas de la extensión moodle-teacher, en lugar de ir haciendo clic:
  • inicias sesión tú, en su ventana, y miyagi nunca ve tu contraseña;
  • los alumnos le llegan al modelo con seudónimo;
  • moodle-teacher solo entra en los cursos de tus asignaturas.
• Tus asignaturas por su nombre. Las nuevas se guardan en ~/.miyagi, y las abres con miyagi chat -w <nombre>, sin manejar carpetas. miyagi workspaces las lista.
• Extensiones. Puedes añadirle capacidades a miyagi desde el repositorio oficial de Falken's Lab: miyagi extension add <nombre>, o /extensions en el chat.
• Prácticas probadas en un laboratorio. Con la extensión docker-lab, miyagi comprueba una práctica en un laboratorio de Docker antes de publicarla, o ejecuta una entrega al corregirla. Te pide una sola aprobación por comprobación. miyagi ya no tiene terminal en ningún sitio.
• La vida de una actividad. Para algo nuevo y complejo (un proyecto, una actividad gamificada, un paquete SCORM) te propone ir por fases: un plan que acordáis, la construcción, la prueba oculta y servirla, cada paso con tu aprobación. Al cerrar la sesión te dice qué tiene «en el horno».
• Tu normativa, cuando la pides. Le das la normativa que te aplica (el currículo de tu comunidad, la orden de evaluación, el calendario escolar), o le pides que la busque en las fuentes oficiales:
  • la guarda citada artículo por artículo;
  • la programación, la evaluación y las fechas la siguen;
  • si le falta una norma, te la pide.
• Evaluación por criterios y atención a la diversidad:
  • una matriz de evaluación que traza cada nota a su criterio;
  • el diseño universal para el aprendizaje en cada tema;
  • variantes de acceso, refuerzo y ampliación, sin guardar datos de ningún alumno.
• Llevar al curso un diseño tuyo. Con la extensión canva, «sube al tema 3 la ficha que hice en Canva» la exporta en el formato que conviene y la publica en su sitio, oculta y con tu aprobación.
• La web de documentación. Una guía para docentes, un aula de Introducción a SQL construida paso a paso con capturas reales, una sección avanzada y una hoja de ruta.

Correcciones

• Al construir varios temas en un mismo encargo, todo nace oculto y se te pide aprobación por cada tema.
• Borrar algo en Moodle te lo pregunta siempre, en cada llamada, aunque acabes de aprobar otra cosa.
• miyagi ya no puede leer tu token de Claude ni las credenciales que tengas en sitios conocidos de tu ordenador.
• Menos frases en inglés en un chat en español (queda algún caso; se sigue en la #26).

Si ya usabas miyagi

• Un aula de las de antes (con usuario y contraseña de Moodle en config.json): al abrirla, miyagi te pregunta si la pasa a moodle-teacher. Si dices que sí, borra el usuario y la contraseña guardados e instala o amplía moodle-teacher. Si dices que no, esa sesión trabaja sin el aula.
• Las prácticas en Docker ya no usan el probador de prácticas ni la opción allowPracticeRunner: instala la extensión docker-lab (miyagi extension add docker-lab --set mode=lab).
• Las asignaturas que ya tenías siguen funcionando donde están, con --dir. La primera vez que las abres quedan en tu lista de asignaturas.

Funciona sobre agent-kit 0.30.1.

miyagi v0.10.0

teacher-agent ahora se llama miyagi

El mismo asistente, con otro nombre, otra cara y otros colores: la de un maestro con su cinta en la frente, y los colores de la tinta, el papel y el rojo del sol.

  .-----.
~=[==o==]
  | = = |
  |/~~~\|
   \_Y_/

Instalar

npm install -g https://github.com/falkenslab/miyagi/releases/latest/download/miyagi.tgz

Y después, miyagi en lugar de teacher-agent: miyagi chat, miyagi init…

Si ya usabas teacher-agent

No tienes que hacer nada para seguir trabajando:

• El comando antiguo sigue funcionando. Si actualizas con el comando de siempre (…/teacher-agent.tgz), el comando teacher-agent arranca miyagi y te recuerda el nombre nuevo.
• Tu configuración pasa sola. La primera vez que arranca, miyagi copia tu configuración de ~/.teacher-agent a ~/.miyagi, incluido el acceso a Claude, así que no tienes que volver a iniciar sesión.
• Tus carpetas de curso sirven tal cual: apuntes, borradores y conversaciones.
• Los comandos del chat pasan de /teacher-agent:… a /miyagi:… (por ejemplo, /miyagi:quiz). Si tienes comandos propios que llaman a los antiguos, cámbiales el nombre.
• Para pasarte del todo: instala miyagi con el comando de arriba y, cuando quieras, quita el paquete antiguo con npm uninstall -g teacher-agent.

El comando y la dirección antiguos funcionarán hasta la versión 1.0.

Otros cambios

• El chat da la bienvenida con «miyagi está listo», porque ya no entra en Moodle al empezar: lo hace cuando se lo pides.
• La web del proyecto está en https://falkenslab.github.io/miyagi/ y el repositorio en https://github.com/falkenslab/miyagi (el enlace antiguo redirige).
• Las pruebas de prácticas en Docker marcan sus contenedores como miyagi=practice. Los que dejara una versión anterior, si queda alguno, se pueden borrar a mano.

Usa agent-kit 0.13.1.

teacher-agent v0.9.0

Instalar o actualizar

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Novedades

• Actividades web como SCORM, con nota en Moodle. El asistente puede empaquetar un juego o una actividad en HTML, tuya o publicada en internet, como paquete SCORM. Moodle registra entonces si el alumno la completó y su nota en el calificador. La descarga con todos sus ficheros, le añade un pequeño puente con Moodle sin cambiar cómo se juega, la sube oculta y la prueba antes de enseñártela. Pídeselo así: «Empaqueta como SCORM el juego https://… y súbelo al Tema 2 para que cuente para la nota». (#1)

• Descargar, comprimir y hacer PDF, sin terminal. En la carpeta drafts del curso, el asistente tiene sus propias herramientas: descargar archivos y páginas web completas, copiar, mover, comprimir y descomprimir, convertir apuntes a PDF y comprobar qué es de verdad un archivo. Solo puede trabajar dentro de drafts. Una descarga no pasa de 50 MB y un ZIP descomprimido de 200 MB (se puede cambiar en el config.json del curso). (#1)

• Los cuestionarios y las páginas se comprueban antes de subirlos. Antes de subir un archivo GIFT o HTML a Moodle, se revisa automáticamente:

  • llaves sin cerrar;
  • un = que partiría una respuesta en dos;
  • una pregunta sin respuesta correcta, o con varias;
  • números con coma decimal;
  • nombres repetidos;
  • el código que perdería su sangría al importarlo;
  • una página que no se vería bien en el móvil.

  Si hay errores, no se sube: el asistente recibe la lista de líneas, lo corrige y vuelve a intentarlo. (#2)

• Web del proyecto, en español y en inglés: https://falkenslab.github.io/teacher-agent/ (#14)

Correcciones

• Si le hablas en un idioma y el curso está en otro, el resumen que te enseña antes de publicar ahora sale en tu idioma, citando tal cual lo que se va a publicar en el idioma del curso. (#15)

Cambios que afectan a tus cursos

Ninguno: tus carpetas de curso sirven tal cual. Si quieres cambiar los límites de descarga o de ZIP, añade en el config.json del curso "agent": { "draftsLimits": { "downloadMB": 100, "unzipMB": 500, "unzipFiles": 5000 } }.

Usa agent-kit 0.13.1.

teacher-agent v0.8.0

Instalar o actualizar

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Novedades

• El chat empieza al instante y solo entra en Moodle cuando hace falta. Te saluda con lo que ya sabe del curso y de cuándo son sus notas, sin abrir el navegador. Responde desde sus notas cuando basta y solo inicia sesión cuando le pides algo que necesita el curso real (entregas, notas, foro) o que actúa en él. Si solo quisiera explorar, te pregunta antes. En un curso sin notas, te ofrece explorarlo o partir de tus documentos. (#4)
• Se entiende lo que hace el navegador. En lugar de fragmentos de código («Ejecutando JavaScript: () => …») dice «Leyendo una tabla de la página», «Escribiendo en el editor de texto» o «Rellenando el formulario». Al plegar un grupo de acciones, resume «abrió 2 páginas, pulsó 3 veces» en vez de «usó 8 herramientas». (#7, #9)
• run, ingest y explore con el aspecto del chat: un indicador de lo que está haciendo en cada momento, los mismos paneles de aprobación y una barra con el modo. Con --plain siguen en texto simple. (#12)
• init y los menús de inicio, también con el aspecto del chat. Las preguntas son las mismas. (#11)
• Colores más legibles: la opción seleccionada en los paneles, en naranja (antes, un azul marino que casi no se veía); los resultados de las herramientas, atenuados, para que en blanco queden solo el asistente y tú; y los colores del búho en viñetas y en el indicador. (#10)

Correcciones

• run ya no intenta grabar la sesión en vídeo. Esa grabación nunca llegó a funcionar (necesitaba un programa que no se instala) y dejaba un error al principio de cada sesión. (#13)
• El aviso «Interrumpiendo… (Ctrl+C otra vez para salir sin esperar)» vuelve a verse en run, y los menús dejan marcada la última respuesta.

Cambios que afectan a tus cursos

Ninguno: tus carpetas de curso sirven tal cual. En chat, el navegador ya no se abre al empezar, sino con la primera petición que lo necesita.

Usa agent-kit 0.13.1.

teacher-agent v0.7.0

Instalar o actualizar

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Novedades

• En tu idioma: español, inglés, francés o alemán. Los menús, avisos, la ayuda, el asistente de init y el chat salen en el idioma que elegiste para el curso (agent.language) o, si no elegiste ninguno, en el del sistema. Para cambiarlo solo una vez: --language=en (o es, fr, de). El asistente también te cuenta lo que va haciendo en ese idioma, no solo sus respuestas finales. Lo que publica en Moodle sigue en el idioma del curso. (#6)
• Las acciones del agente, en gris. En el chat, las líneas de lo que va haciendo («Abriendo…», «Pulsando…») salen atenuadas, para que no se confundan con sus respuestas. (#5)
• La versión en la cabecera del chat, junto al búho: «teacher-agent v0.7.0». (#8)
• Un búho con birrete como logo del chat y del README.

Correcciones

• En el foro, el panel «Publicación sin aprobación previa» ya no salta al pulsar «Reply» para abrir el formulario de respuesta: solo salta al publicar de verdad.

Cambios que afectan a tus cursos

Ninguno: tus carpetas de curso sirven tal cual. Si en agent.language escribiste un idioma que no es español, inglés, francés ni alemán, los menús saldrán en el idioma del sistema; el asistente te seguirá respondiendo en el tuyo.

Usa agent-kit 0.12.0.

teacher-agent v0.6.0

Instalación

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Novedades

• Retoma una conversación donde la dejaste. El asistente ya no olvida lo que hablasteis al cerrar el chat:

  • teacher-agent chat --continue abre la última conversación de ese curso;
  • dentro del chat, /resume muestra las anteriores (fecha y último mensaje) para elegir una.

  Recuerda lo acordado y no vuelve a saludar. Cada conversación se guarda en la carpeta sessions del curso, junto con su registro.

• El chat, en español. La barra de estado, los paneles de aprobación, los atajos y los avisos del chat salen ya en español. Si el curso está configurado en inglés, francés o alemán (agent.language), salen en ese idioma, y --language=<código> (es, en, fr, de) lo cambia al arrancar.

• Sesiones más ligeras. El asistente solo carga sus propias habilidades y las que hayas añadido al curso, así que cada paso consume menos.

Correcciones

• Tu configuración de Claude Code ya no se cuela. Tus ajustes personales, instrucciones o memoria de Claude Code dejan de llegar al asistente: trabaja solo con lo del curso.

Cambios en los cursos que ya tienes

• Conversaciones anteriores: las de antes de esta versión no aparecen en /resume ni se pueden retomar. Las nuevas sí.
• Nada que hacer: no tienes que cambiar nada.

Por dentro

• Usa agent-kit 0.12.0.

teacher-agent v0.5.1

Instalación

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Correcciones

• La tecla Supr del chat borra hacia la derecha. Borraba el carácter a la izquierda del cursor, como Retroceso. Ahora borra el que hay a la derecha, o un bloque pegado entero si está justo después del cursor. Al final de la línea no hace nada.

Cambios en los cursos que ya tienes

Ninguno.

Por dentro

• Usa agent-kit 0.10.2.

teacher-agent v0.5.0

Instalación

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Novedades

• Chat nuevo, a pantalla completa. teacher-agent chat ocupa toda la terminal:

  • la conversación con formato (negritas, listas, tablas);
  • lo que va haciendo el agente, resumido en una línea;
  • paneles de aprobación numerados (1, y o Intro aprueban; 2 o n rechazan);
  • una barra de estado abajo.

  Puedes desplazarte con la rueda del ratón o RePág, y copiar texto arrastrando con el ratón y haciendo clic derecho. ? muestra todos los atajos. Si prefieres el chat de antes: --inline (sin pantalla completa) o --plain (texto simple).

• Cambiar de modo en plena conversación. Shift+Tab alterna entre guided (pide permiso solo para lo que publica) e interactive (pide permiso para cada paso).

• Nada se publica sin tu permiso, garantizado. Hasta ahora el permiso antes de publicar dependía de que el asistente se acordara de pedirlo, y en una ocasión no lo hizo. Ahora, si va a guardar o publicar algo que ven los alumnos sin haberte preguntado, se detiene y te pregunta él. Una sola aprobación puede cubrir un lote (por ejemplo, las notas de una tarea), siempre que el resumen enumere cada elemento.

• Lo nuevo se prueba antes de que lo vean los alumnos. Cuando crea un recurso (un cuestionario, una página, una actividad web…):

  • lo prepara en la carpeta drafts del curso;
  • lo sube a Moodle oculto, con tu permiso;
  • lo prueba ahí;
  • te pide permiso otra vez para mostrarlo.

  En las pruebas encontró así, antes que los alumnos, código que perdía la sangría al importar preguntas y una página que no cabía en el móvil. Lo que dejes oculto queda apuntado en knowledge/drafts.md, y te lo recuerda al cerrar y al volver a abrir el chat.

• explore también mira cómo se califica en tu Moodle: qué formas de calcular la nota del curso admite y si hay penalizaciones por retraso. Así no lo descubre a mitad de construir un curso.

Correcciones

• Comentarios de retroalimentación perdidos. En algunos casos la nota se guardaba sin el comentario. Ahora el asistente comprueba que se han guardado los dos y no te dice que un alumno tiene un comentario que no ha visto guardado.
• explore ya no sale de tu curso. Si tu curso no tiene cuestionarios, apunta que no pudo comprobar los tipos de pregunta, en vez de ir a mirarlos a otro curso.
• Construir cursos, más ordenado:
  • el libro de calificaciones se decide antes de la primera actividad calificable;
  • no promete penalizaciones que tu Moodle no tiene;
  • no publica compromisos en tu nombre que no hayas decidido.
• Configurar un curso desde el chat ya no lo abre a continuación. Al lanzar teacher-agent o teacher-agent chat en una carpeta que todavía no es un curso, te hace las preguntas, guarda la configuración y termina. Vuelve a lanzarlo para empezar.

Cambios en los cursos que ya tienes

• Carpeta nueva: se crea sola la carpeta drafts. No tienes que hacer nada.
• Ficheros de preguntas: los ficheros GIFT de preguntas nuevos van en drafts. Los que ya tengas en knowledge/activities se quedan donde están.

Por dentro

• Usa agent-kit 0.10.1, instalado ya desde npm.

teacher-agent v0.4.0

Versión de orden interno: el asistente sabe lo mismo que en la 0.3.0, pero cada cosa está ahora en un solo sitio, lo que hace su trabajo más coherente y predecible.

Instalación y actualización

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

Cambios

• Una sola programación por curso. Al construir un curso sin programación, el asistente redacta un borrador de la programación didáctica (con sus propuestas marcadas para que las confirmes) en lugar de un plan aparte. Es la misma que luego usa para comprobar que el aula está acorde.
• Una comprobación antes de publicar, igual para todo: redacción, accesibilidad y cómo lo verá un alumno. Las reglas de cuándo te pide aprobación también están ahora en un solo sitio.
• Cuestionarios completos: además de escribir e importar preguntas, configura el cuestionario (fechas, tiempo, intentos, cómo se muestran las respuestas) según sea de repaso o de evaluación. /teacher-agent:quiz crea el cuestionario si no existe.
• Apuntes de verdad: una habilidad propia para escribir los apuntes y recursos del curso, con explicaciones, ejemplos y fuentes.
• Foro: cuándo intervenir y cómo escribir, en una sola habilidad.
• La auditoría del curso tiene en cuenta tu programación y la opinión del revisor pedagógico, y el historial de progreso nunca guarda nombres de alumnos.

Cambios que te afectan

• El atajo /teacher-agent:pending se llama ahora /teacher-agent:progress.
• Si tenías habilidades propias que citaban por nombre content-editor, accessibility, forum-post, forum-facilitation, activity-design, content-authoring o quiz-bulk-import, cámbialas por publish-check, forum, assignment-building/activity-building, resource-authoring o quiz-building.

Usa agent-kit v0.6.0.

teacher-agent v0.3.0

teacher-agent ya no solo gestiona el curso: ahora te ayuda a diseñarlo como lo haría un docente con experiencia en metodologías, a escribir tu programación didáctica y a que el aula de Moodle esté de acuerdo con ella.

Instalación y actualización

npm install -g https://github.com/falkenslab/teacher-agent/releases/latest/download/teacher-agent.tgz

El mismo comando actualiza una instalación anterior.

Novedades

• Construir un curso completo a partir de una descripción (/teacher-agent:build-course, o teacher-agent run --task "…"), o un solo tema dentro de un curso que ya existe (/teacher-agent:build-unit), encajado en su calendario, sus pesos y su estilo.
• Programación didáctica (/teacher-agent:teaching-plan): la escribe a partir de tu borrador o tu material, te pregunta lo que solo tú decides y la guarda en sus apuntes, enlazada con cada tema.
• Alinear el aula con la programación (/teacher-agent:align): criterios que nada evalúa, rúbricas que faltan, pesos o fechas distintos, temas sin construir. Lo corrige con tu aprobación.
• Metodologías didácticas: aprendizaje basado en proyectos, retos y problemas, clase invertida, gamificación con insignias y niveles, trabajo cooperativo, estudio de casos, aprendizaje-servicio, design thinking, DUA… montadas con las piezas de Moodle que las hacen posibles.
• Tareas y actividades de todo tipo: tareas escritas, con archivos, en grupo, por borradores, portafolio, exposición; talleres de coevaluación, lecciones con itinerarios, glosarios, wikis, bases de datos, consultas, encuestas, H5P, libros, y finalización, restricciones e insignias. Toda actividad corregida a mano lleva su rúbrica en Moodle.
• Ayudantes: un investigador que busca en internet con fuentes citadas (/teacher-agent:research) y un revisor pedagógico que da una segunda opinión sobre cada plan antes de publicarlo.
• Probar prácticas con Docker (opcional, desactivado por defecto): comprueba que las prácticas funcionan antes de publicarlas, siempre dentro de contenedores y sin tocar nada tuyo.

Correcciones

• Una aprobación por cada contenido nuevo (antes podía importar las preguntas de un cuestionario sin enseñártelas).
• Las preguntas de los cuestionarios quedan en el orden previsto.
• Explica bien las penalizaciones por retraso de Moodle 5 (existen si el administrador las activa).

Todo esto se ha probado construyendo y alineando un curso real en un Moodle de pruebas: los informes están en tests/.

Usa agent-kit v0.6.0. Las carpetas de curso existentes siguen funcionando; la primera vez te preguntará si quieres activar la prueba de prácticas con Docker.