Files
pinion-innovation-content/docs/user-guide-ES.md

22 KiB

Guía del Usuario

Contenido de Innovación: Modos y Habilidades de Desarrollo de Contenido Educativo

Versión: 1.1.1 Audiencia: Desarrolladores de Contenido Educativo, Diseñadores Instruccionales, Productores de Contenido Fecha: 2026-04-24


1. Introducción

1.1 ¿Qué es Contenido de Innovación?

Contenido de Innovación es un conjunto especializado de modos y habilidades para Roo Code que transforma cómo se crea, revisa y entrega el contenido educativo. Piensa en ello como tener seis colegas expertos—cada uno especializado en un aspecto diferente del desarrollo de contenido educativo—trabajando junto a ti en tu editor de código.

1.2 Conceptos Clave

Modos

Un modo es una configuración especializada de Roo Code adaptada a un rol específico. Cuando activas un modo, Roo Code adopta el comportamiento, permisos y experiencia de ese rol.

Modo Rol Cuándo Usar
📝 Diseñador Curricular Arquitecto educativo Al diseñar currículos, objetivos de aprendizaje y estructuras de curso
📖 Escritor Instruccional Autor de contenido Al escribir contenido de lecciones, ejercicios y documentación para aprendices
🧪 Desarrollador de Evaluaciones Especialista en medición Al crear cuestionarios, rúbricas y criterios de evaluación
🎬 Productor de Contenido Creador multimedia Al producir guiones de video, contenido interactivo y activos multimedia
🎨 Diseñador de Experiencia de Aprendizaje Especialista en engagement Al diseñar journeys de aprendizaje, gamificación y microaprendizaje
Auditor de Accesibilidad Especialista en inclusión Al auditar contenido para cumplimiento WCAG y accesibilidad

Habilidades

Una habilidad es una capacidad reutilizable que los modos pueden invocar. Las habilidades son como herramientas especializadas en un taller—cada una hace un trabajo específico bien.

Por ejemplo, el modo Diseñador Curricular tiene estas habilidades:

  • learning-objective-validator — Verifica que los objetivos usen verbos apropiados de la Taxonomía de Bloom
  • competency-mapper — Mapea objetivos a estándares como Common Core o NGSS
  • curriculum-gap-analyzer — Encuentra brechas en la cobertura del currículo

1.3 Cómo Funciona

Proporcionas entrada → El modo la procesa usando habilidades → Obtienes salida estructurada

Cada modo sigue un flujo de trabajo definido, aplica mejores prácticas y se comunica con otros modos a través de transferencias estandarizadas.


2. Primeros Pasos

2.1 Tu Primera Sesión

Paso 1: Elige Tu Modo

Piensa en lo que intentas lograr:

  • "Necesito diseñar un nuevo curso" → Diseñador Curricular
  • "Necesito escribir contenido de lección" → Escritor Instruccional
  • "Necesito crear un cuestionario" → Desarrollador de Evaluaciones
  • "Necesito producir un video" → Productor de Contenido
  • "Necesito diseñar un journey de aprendizaje" → Diseñador LX
  • "Necesito verificar accesibilidad" → Auditor de Accesibilidad

Paso 2: Activa el Modo

En Roo Code, cambia a tu modo elegido:

Switch to curriculum-designer mode

Paso 3: Proporciona Tu Entrada

Da al modo contexto sobre en qué estás trabajando:

Necesito crear un currículo para un curso de biología de secundaria sobre fotosíntesis.
La audiencia objetivo son estudiantes de noveno grado. El curso debe alinearse con estándares NGSS.

Paso 4: Revisa la Salida

El modo generará salida estructurada. Revísala y proporciona retroalimentación:

Los objetivos de aprendizaje se ven bien, pero me gustaría más énfasis en las reacciones dependientes de la luz.

2.2 El Flujo de Trabajo de Desarrollo de Contenido

Los seis modos trabajan juntos en un pipeline:

1. El Diseñador Curricular define QUÉ enseñar
   ↓
2. El Escritor Instruccional crea CÓMO enseñarlo
   ↓
3. El Desarrollador de Evaluaciones crea CÓMO medir el aprendizaje
   ↓
4. El Productor de Contenido crea materiales MULTIMEDIA
   ↓
5. El Diseñador LX crea experiencias ATRACTIVAS
   ↓
6. El Auditor de Accesibilidad asegura que TODOS puedan acceder

Puedes comenzar en cualquier punto del pipeline dependiendo de tu rol.


3. Usar los Modos Efectivamente

3.1 Modo Diseñador Curricular

Ideal para: Arquitectos de cursos, coordinadores de currículo, diseñadores instruccionales

Lo que hace:

  • Valida objetivos de aprendizaje usando la Taxonomía de Bloom
  • Mapea objetivos a estándares educativos
  • Identifica brechas en la cobertura del currículo
  • Valida cadenas de prerrequisitos

Cómo obtener los mejores resultados:

  1. Sé específico sobre tu audiencia:

    Bueno: "Crear objetivos para estudiantes de química de décimo grado"
    Mejor: "Crear 8 objetivos medibles para química de décimo grado sobre enlace químico, alineados a NGSS HS-PS1-2"
    
  2. Proporciona estándares existentes:

    "Alinea este currículo a los estándares de Matemáticas Common Core para Álgebra II, específicamente los clústeres A-SSE, A-APR y F-IF"
    
  3. Solicita análisis de brechas:

    "Analiza este currículo para brechas. ¿Hay alguna expectativa de desempeño NGSS no cubierta?"
    

Consejo profesional: Comienza con el fin en mente. Dile al Diseñador Curricular qué deberían poder HACER los estudiantes después de completar el curso, y trabajará hacia atrás para diseñar el currículo.

3.2 Modo Escritor Instruccional

Ideal para: Escritores de contenido, expertos en materia, profesores

Lo que hace:

  • Analiza legibilidad del contenido (Flesch-Kincaid, SMOG)
  • Asegura consistencia de tono en lecciones
  • Diseña ejercicios de aprendizaje activo
  • Evalúa calidad de explicaciones

Cómo obtener los mejores resultados:

  1. Especifica el nivel de lectura de tu audiencia:

    "Escribe esta lección para nivel de lectura de octavo grado (Flesch-Kincaid grado 8)"
    
  2. Proporciona los objetivos de aprendizaje:

    "Escribe una lección que ayude a los estudiantes a lograr este objetivo: 'Los estudiantes podrán explicar el proceso de fotosíntesis'"
    
  3. Solicita aprendizaje activo:

    "Incluye 3 ejercicios de aprendizaje activo: uno individual, uno en pareja y uno en grupo"
    

Consejo profesional: Usa la estructura Enganchar-Definir-Ejemplo-Elaborar-Verificar para explicaciones. El Escritor Instruccional seguirá este patrón automáticamente si pides "explicaciones bien estructuradas."

3.3 Modo Desarrollador de Evaluaciones

Ideal para: Diseñadores de evaluaciones, desarrolladores de pruebas, evaluadores

Lo que hace:

  • Valida alineación de evaluaciones a objetivos
  • Realiza análisis de ítems (dificultad, discriminación)
  • Genera rúbricas con descriptores de desempeño
  • Detecta sesgo en ítems de evaluación

Cómo obtener los mejores resultados:

  1. Proporciona los objetivos de aprendizaje:

    "Crea 10 preguntas de opción múltiple que evalúen este objetivo: 'Los estudiantes podrán resolver ecuaciones cuadráticas'"
    
  2. Especifica distribución de dificultad:

    "Incluye 3 fáciles, 5 medias y 2 difíciles"
    
  3. Solicita revisión de sesgo:

    "Revisa estos ítems de evaluación para sesgo de género, cultural y socioeconómico"
    

Consejo profesional: Siempre pide una rúbrica al crear evaluaciones de desempeño. La habilidad rubric-generator crea rúbricas analíticas con descriptores claros de desempeño para cada nivel.

3.4 Modo Productor de Contenido

Ideal para: Productores de video, diseñadores multimedia, desarrolladores de e-learning

Lo que hace:

  • Valida storyboards contra objetivos
  • Gestiona activos multimedia
  • Empaqueta contenido para entrega SCORM/xAPI a LMS
  • Crea contenido interactivo H5P

Cómo obtener los mejores resultados:

  1. Proporciona el storyboard o guion:

    "Crea un storyboard de video explicativo de 5 minutos sobre el ciclo del agua para estudiantes de secundaria"
    
  2. Especifica requisitos de accesibilidad:

    "Asegura que todo el contenido de video incluya subtítulos y transcripciones"
    
  3. Solicita empaquetado SCORM:

    "Empaqueta este contenido como un paquete SCORM 2004 para Moodle LMS"
    

Consejo profesional: Mantén los videos bajo 6 minutos para engagement óptimo. El Productor de Contenido sugerirá automáticamente dividir contenido más largo en micro-videos.

3.5 Modo Diseñador de Experiencia de Aprendizaje

Ideal para: Diseñadores UX, especialistas en engagement, tecnólogos de aprendizaje

Lo que hace:

  • Mapea journeys y rutas de aprendizaje
  • Analiza patrones de engagement
  • Diseña elementos de gamificación
  • Arquitecta estructuras de microaprendizaje

Cómo obtener los mejores resultados:

  1. Proporciona el paquete de contenido:

    "Diseña un journey de aprendiz para este curso de 8 módulos sobre ciencia de datos. Cada módulo toma unos 30 minutos"
    
  2. Especifica objetivos de engagement:

    "Incluye elementos de gamificación que motiven la completación sin depender de recompensas extrínsecas"
    
  3. Solicita estructura de microaprendizaje:

    "Divide este módulo de 2 horas en unidades de microaprendizaje de 5-15 minutos cada una"
    

Consejo profesional: Enfócate en motivación intrínseca. La habilidad gamification-designer prefiere insignias y sistemas de logro que reconocen dominio sobre puntos y tablas de clasificación.

3.6 Modo Auditor de Accesibilidad

Ideal para: Especialistas en accesibilidad, probadores QA, revisores de contenido

Lo que hace:

  • Audita cumplimiento WCAG 2.1/2.2 en niveles A, AA, AAA
  • Simula experiencia de lector de pantalla
  • Analiza ratios de contraste de color
  • Proporciona guía de remediación

Cómo obtener los mejores resultados:

  1. Proporciona el contenido a auditar:

    "Audita esta página de lección para cumplimiento WCAG 2.1 AA"
    
  2. Especifica el nivel objetivo:

    "Verifica este contenido contra los criterios de éxito WCAG 2.2 AA"
    
  3. Solicita guía de remediación:

    "Para cada problema encontrado, proporciona pasos específicos de remediación con ejemplos de código"
    

Consejo profesional: Ejecuta el Auditor de Accesibilidad temprano y a menudo. Es más fácil corregir problemas de accesibilidad durante la creación que después de la publicación.


4. Optimizar Tu Flujo de Trabajo

4.1 Estrategias para Ahorrar Tiempo

Estrategia Descripción Tiempo Ahorrado
Agrupar tareas similares Agrupa toda la escritura de objetivos, luego toda la escritura de lecciones, luego toda la creación de evaluaciones 20-30%
Usar transferencias entre modos Deja que los modos se pasen trabajo automáticamente 15-25%
Invocar habilidades directamente Invoca habilidades específicas cuando solo necesitas una capacidad 10-20%
Plantillar tus entradas Crea plantillas de entrada reutilizables para tareas comunes 25-35%

4.2 Plantillas de Entrada

Plantilla de Diseño Curricular:

Rol: Diseñador Curricular
Tarea: Crear currículo para [materia] en [nivel]
Audiencia: [audiencia objetivo, edad, conocimientos previos]
Estándares: [estándares educativos a los que alinearse]
Duración: [duración del curso, duración de sesión]
Objetivos: [número de objetivos deseados]
Formato de salida: [documento de currículo, lista de objetivos, etc.]

Plantilla de Escritura de Lecciones:

Rol: Escritor Instruccional
Tarea: Escribir lección sobre [tema]
Audiencia: [audiencia objetivo, nivel de lectura]
Objetivos: [objetivos de aprendizaje que aborda esta lección]
Duración: [conteo de palabras estimado o duración]
Actividades: [tipos de actividades a incluir]
Tono: [formal, conversacional, etc.]

Plantilla de Creación de Evaluaciones:

Rol: Desarrollador de Evaluaciones
Tarea: Crear evaluación para [tema/objetivo]
Tipo: [opción múltiple, ensayo, desempeño, etc.]
Ítems: [número de ítems]
Dificultad: [distribución: fácil/medio/difícil]
Rúbrica: [sí/no, tipo de rúbrica]
Revisión de sesgo: [sí/no]

4.3 Colaboración entre Modos

Escenario: Crear un Curso Completo

  1. Comienza con el Diseñador Curricular:

    "Diseña un currículo de 6 módulos sobre programación Python para principiantes.
    Alinea a estándares CSTA. Cada módulo debe tener 3-5 objetivos medibles."
    
  2. Transfiere al Escritor Instruccional:

    "Pasa este currículo al Escritor Instruccional. Escribe contenido de lección
    para el Módulo 1: Variables y Tipos de Datos. Nivel de lectura objetivo: grado 10."
    
  3. Transfiere al Desarrollador de Evaluaciones:

    "Pasa la lección del Módulo 1 al Desarrollador de Evaluaciones. Crea un cuestionario
    de 15 ítems con 5 fáciles, 7 medios, 3 difíciles. Incluye una rúbrica para
    el ejercicio de codificación."
    
  4. Transfiere al Productor de Contenido:

    "Pasa la lección y evaluación al Productor de Contenido. Crea un storyboard
    de video explicativo de 5 minutos y 2 actividades interactivas H5P."
    
  5. Transfiere al Diseñador LX:

    "Pasa el paquete completo del Módulo 1 al Diseñador LX. Diseña el journey
    de aprendiz con un punto de control de progreso y una insignia para completación."
    
  6. Transfiere al Auditor de Accesibilidad:

    "Pasa todo el contenido del Módulo 1 al Auditor de Accesibilidad. Audita para
    cumplimiento WCAG 2.1 AA y proporciona guía de remediación para cualquier problema."
    

4.4 Errores Comunes y Cómo Evitarlos

Error Impacto Prevención
Objetivos vagos Desalineación de contenido Usa learning-objective-validator antes de proceder
Saltar accesibilidad Aprendices excluidos Ejecuta wcag-compliance-checker en cada etapa
Tono inconsistente Contenido confuso Usa tone-consistency-checker en todas las lecciones
Evaluaciones desalineadas Medición inválida Usa assessment-validator para verificar alineación
Videos demasiado largos Desengagement del aprendiz Mantén videos bajo 6 minutos; usa microlearning-architect
Gamificación extrínseca Motivación a corto plazo Usa gamification-designer con enfoque en motivación intrínseca

5. Uso Avanzado

5.1 Personalizar Comportamiento de Modos

Cada modo puede personalizarse proporcionando contexto adicional en tus prompts:

"Como Diseñador Curricular, prioriza el aprendizaje basado en proyectos sobre instrucción directa.
Diseña objetivos que enfatizen los niveles de creación y evaluación de la Taxonomía de Bloom."
"Como Escritor Instruccional, usa un enfoque de cuestionamiento socrático. Incluye prompts
de reflexión después de cada concepto principal."

5.2 Combinar Habilidades

Puedes invocar múltiples habilidades en secuencia para análisis comprehensivo:

"Primero, usa readability-analyzer para verificar el nivel de lectura de esta lección.
Luego, usa tone-consistency-checker para asegurar que coincide con nuestra guía de estilo.
Finalmente, usa explanation-quality-checker para evaluar las explicaciones."

5.3 Refinamiento Iterativo

Los modos soportan refinamiento iterativo. Después de recibir salida, puedes pedir cambios:

"Los objetivos están bien, pero hazlos más específicos a las expectativas de desempeño NGSS.
Agrega dos objetivos más en el nivel 'Crear' de la Taxonomía de Bloom."
"La lección es demasiado técnica. Simplifica el lenguaje a nivel de lectura de grado 8
y agrega más ejemplos concretos."

5.4 Verificaciones de Calidad

Antes de finalizar cualquier contenido, ejecuta estas verificaciones de calidad:

Verificación Habilidad Cuándo Usar
Calidad de objetivos learning-objective-validator Después del diseño curricular
Legibilidad readability-analyzer Después de escribir lección
Alineación de evaluación assessment-validator Después de crear evaluación
Revisión de sesgo bias-detector Antes de publicar evaluaciones
Cumplimiento WCAG wcag-compliance-checker Antes de publicar cualquier contenido
Alineación de storyboard storyboard-validator Antes de producción de video

6. Preguntas Frecuentes

P: ¿Puedo usar múltiples modos en una sesión?

R: Sí. Puedes cambiar entre modos según sea necesario. Los modos están diseñados para transferirse trabajo entre sí, así que puedes comenzar en un modo y continuar en otro.

P: ¿Cómo sé qué modo usar?

R: Consulta la tabla de modos en la Sección 1.2. Si no estás seguro, comienza con Diseñador Curricular—es la base para todo el trabajo demás.

P: ¿Puedo personalizar las habilidades?

R: Las habilidades están diseñadas para ser autocontenidas. Si necesitas modificar el comportamiento de una habilidad, consulta la Guía del Equipo de Soporte para instrucciones sobre extender habilidades.

P: ¿Qué pasa si la salida no satisface mis necesidades?

R: Proporciona retroalimentación específica y pide revisiones. Los modos soportan refinamiento iterativo. Por ejemplo: "Los objetivos son demasiado generales. Hazlos más específicos y medibles."

P: ¿Cómo aseguro consistencia en un proyecto grande?

R: Usa la habilidad tone-consistency-checker en todo el contenido escrito, y ejecuta standards-compliance-checker en el currículo completo. El Auditor de Accesibilidad también puede asegurar consistencia en todo el contenido publicado.

P: ¿Puedo usar estos modos para contenido no educativo?

R: Aunque diseñados para contenido educativo, muchas habilidades (como readability-analyzer, tone-consistency-checker y wcag-compliance-checker) son aplicables a cualquier creación de contenido.


7. Referencia Rápida

Guía de Selección de Modos

Si necesitas... Usa este modo Habilidad clave
Definir qué deben aprender los estudiantes Diseñador Curricular learning-objective-validator
Escribir contenido de lección Escritor Instruccional explanation-quality-checker
Crear un cuestionario o prueba Desarrollador de Evaluaciones assessment-validator
Producir un video Productor de Contenido storyboard-validator
Diseñar un camino de aprendizaje Diseñador LX journey-mapper
Verificar accesibilidad Auditor de Accesibilidad wcag-compliance-checker
Verificar nivel de lectura Escritor Instruccional readability-analyzer
Crear una rúbrica Desarrollador de Evaluaciones rubric-generator
Empaquetar para LMS Productor de Contenido scorm-packager
Agregar gamificación Diseñador LX gamification-designer

Referencia Rápida de la Taxonomía de Bloom

Nivel Verbos Clave Ejemplo
Recordar listar, definir, identificar, recordar "Lista las partes de una célula"
Comprender explicar, describir, resumir "Explica cómo funciona la fotosíntesis"
Aplicar usar, resolver, demostrar "Usa la fórmula para resolver el problema"
Analizar comparar, contrastar, diferenciar "Compara mitosis y meiosis"
Evaluar juzgar, criticar, justificar "Justifica tu respuesta con evidencia"
Crear diseñar, construir, producir "Diseña un experimento para probar..."

Referencia Rápida de WCAG 2.1

Principio Qué significa Verificación clave
Perceptible Los usuarios pueden percibir contenido Texto alt, subtítulos, contraste de color
Operable Los usuarios pueden interactuar con contenido Navegación por teclado, sin límites de tiempo
Comprensible Los usuarios pueden entender contenido Lenguaje claro, navegación consistente
Robusto El contenido funciona con tecnología asistiva HTML válido, etiquetas ARIA

8. Recursos Adicionales

  • Guía del Equipo de Soporte: Consulta docs/support-team-guide.md para instrucciones de instalación y extensión
  • Plan de Desarrollo: Consulta docs/plan.md para la hoja de ruta del proyecto
  • Especificación de Requisitos: Consulta docs/srs.md para requisitos detallados
  • Configuración de Agentes: Consulta AGENTS.md para directrices de comportamiento de agentes
  • Versiones en Español: Todos los documentos están disponibles en español con sufijo -ES (ej. docs/plan-ES.md)

9. Glosario

Término Definición
Taxonomía de Bloom Un marco para clasificar objetivos de aprendizaje por nivel cognitivo (Recordar, Comprender, Aplicar, Analizar, Evaluar, Crear)
Modo Una configuración especializada de Roo Code para un rol específico
Habilidad Una capacidad reutilizable que los modos pueden invocar
WCAG Pautas de Accesibilidad para el Contenido Web—estándares internacionales para accesibilidad web
SCORM Modelo de Referencia de Objeto de Contenido Compartible—un estándar para empaquetar contenido e-learning
xAPI API de Experiencia (Tin Can API)—una especificación para rastrear experiencias de aprendizaje
NGSS Next Generation Science Standards—estándares de educación científica en EE.UU.
CSTA Computer Science Teachers Association—estándares de educación en computación
H5P HTML5 Package—un estándar para crear contenido web interactivo
Microaprendizaje Dividir contenido en unidades pequeñas (5-15 minutos) para mejor retención