Clase Magistral

¿Qué hace Clase Magistral?

Convierte material de estudio en un curso en video que el estudiante realmente querría ver. Esta habilidad se encarga de la pedagogía (lectura, mapa del curso, guiones). El renderizado (diagramas, voz, MP4, notas de Obsidian) lo realiza la habilidad complementaria master-class-render.

Enrutamiento del modelo (instrucción explícita del usuario)

PEDAGOGY_MODEL: claude-sonnet-5.5    # lectura, mapa del curso, guiones (pasos 1–4). El modelo más barato que mantiene la calidad; cámbialo aquí si es necesario.

La calidad depende casi por completo de los pasos 1–4, por lo que deben ejecutarse en PEDAGOGY_MODEL. Los pasos 0, 5 y 6 son mecánicos y se ejecutan en el modelo que esté dirigiendo la sesión actual.

• Si ya te estás ejecutando como PEDAGOGY_MODEL (o el usuario indica que omitas la delegación), realiza los pasos 1–4 tú mismo.
• De lo contrario, delega. Lanza un sub-agente general-purpose con model: PEDAGOGY_MODEL. Configurar el modelo aquí es la solicitud explícita del usuario. Su prompt debe incluir: la ruta de origen, el idioma de salida, la ruta de la carpeta de origen, cualquier enfoque/contexto que haya dado el usuario, y "Lee ~/.copilot/skills/master-class/SKILL.md y sigue los pasos 1–2 exactamente; escribe course-map.md, luego detente y devuelve el mapa."
  • Muestra el mapa devuelto al usuario y espera su aprobación (a menos que el usuario haya solicitado ejecutar sin aprobaciones).
  • Luego envía la aprobación/cambios al mismo agente (write_agent): "Aprobado [+ cambios]. Ahora realiza los pasos 3–4 exactamente: escribe cada guión, corrige errores hasta que no haya ninguno, escribe scripts/README.md, luego devuelve el resumen de la corrección."
  • Luego continúa tú mismo con el paso 5 (renderizado), que no necesita un modelo grande.
• Si el usuario menciona un modelo diferente para la pedagogía en la solicitud, usa ese.

Lista de lectura (antes de escribir nada)

1. references/cheatsheet.md: una página con las reglas que importan.
2. references/learner-profile.md: quién es el alumno, cómo piensa, qué analogías funcionan.
3. references/lesson-template.md: el esqueleto para completar de cada lección.
4. Ejemplos aprobados, todos de un mismo curso (Lab 02, Uso de Herramientas y MCP): examples/course-map.md, 01 (una frase incorrecta → mecanismo), 05 (una historia → una regla), 08 (sopesando opciones → por qué existe un estándar). Imita su profundidad y tono, no su redacción.
5. Opcional: references/teaching-research.md, las evidencias y fuentes detrás de las reglas.

Reglas de enseñanza no negociables

1. Problema antes que solución. Cada lección comienza con una situación concreta en la que algo falla o duele. La tecnología se nombra solo después del problema y de las alternativas obvias rechazadas.
2. Enseña la intención, no la implementación. Si el material enseña X, el alumno debe entender qué es X, por qué existe, cuándo usarlo y cuándo no. El código es evidencia de un concepto ya explicado (≤ 6 líneas), nunca una guía paso a paso.
3. Desmonta un concepto erróneo por lección, en voz alta.
4. De lo concreto a lo abstracto, con un ejemplo conductor que recorra todo el curso.
5. La forma de pensar del alumno: contexto → restricción real → opciones consideradas y por qué se rechazó cada una → decisión → coste/compensación → cuándo no usarlo. Pregunta explícitamente "¿hay algo mejor?".
6. Pausa de recuperación en cada lección: pregunta → … (el renderizador inserta una pausa de 4 s) → respuesta con su razón.
7. Puente: cada lección termina con el problema que resuelve la siguiente.
8. Sin límite de duración, pero un objetivo de aprendizaje por lección (normalmente 4–6 min).
9. Varía las aperturas, los hilos conductores y los cierres; nunca uses un molde fijo.
10. Nunca inventes hechos o números. Las afirmaciones técnicas provienen de las fuentes leídas o de la documentación oficial verificada; los escenarios hipotéticos deben ser claramente escenarios.

Flujo de trabajo

0 · Preguntar primero

• Idioma de salida: pregunta siempre a menos que el usuario ya lo haya indicado.
• Ruta de origen, si falta. Valores predeterminados (confirma solo si la estructura de la bóveda es diferente):
  • notas → <carpeta del laboratorio>/Master class/
  • videos → <carpeta del laboratorio>/_attachments/master-class/
  • fuentes → <carpeta del laboratorio>/_attachments/master-class/source/ (course-map.md, scripts/, scenes/)
• Aplica Enrutamiento del modelo (arriba).

1 · Leer con profundidad limitada

• Lee el laboratorio o la nota por completo. Para cuadernos, lee el markdown y los conceptos que demuestra el código; nunca ejecutes cuadernos ni leas secretos o .env.
• Sigue [[wikilinks]]/documentos enlazados hasta 2 niveles de profundidad, solo si son relevantes para la intención del material. Omite laboratorios futuros, prerrequisitos ya cubiertos y tangentes.
• Se permite la web para verificar o completar el por qué (documentación oficial y especificaciones). Cítala.
• Mantén un registro: leído / descartado + motivo.

2 · Mapa del curso → detente para aprobación

Escribe <source>/course-map.md como examples/course-map.md:

• la intención en 2–3 frases, como lo que el alumno será capaz de decidir;
• el registro de lectura;
• una tabla de lecciones: # · lección · problema con el que abre · concepto erróneo · analogía/apertura · resuelve → deja abierto, con la lección 00 como visión general y la última lección como síntesis en decisiones.

3 · Guiones, una lección por iteración

Para cada lección, en orden:

1. Vuelve a leer la chuleta, la plantilla, la fila de la lección en el mapa y un ejemplo.
2. Copia references/lesson-template.md en <source>/scripts/NN - Título corto.script.md y complétalo. El sufijo .script.md es obligatorio, porque de lo contrario Obsidian confunde los guiones con las notas de la lección.
3. Corrígelo (paso 4) y arréglalo antes de pasar a la siguiente lección.

La narración está escrita para el oído: sin listas, tablas ni URL; los números como la gente los dice; ids/código entre comillas invertidas (léanse como palabras). El ritmo de recuperación se titula Pausa de recuperación y tiene … entre la pregunta y la respuesta. Si su Pantalla es la pregunta en sí, escríbela como *"pregunta"*.

Finalmente, escribe <source>/scripts/README.md: tabla de lecciones + autoevaluación con rúbrica.

4 · Corrección + rúbrica (debe pasar antes del renderizado)

python3 ~/.copilot/skills/master-class/scripts/lint_script.py "<source>/scripts" --sources "<carpeta del laboratorio>" <otras notas leídas>

Corrige cada ERROR. Corrige cada ADVERTENCIA a menos que sea intencionada (por ejemplo, un número hipotético en un escenario claramente hipotético). El linter no puede juzgar estas, así que revísalas tú mismo:

• Por qué antes del cómo: la tecnología aparece solo después de las alternativas rechazadas
• Comprensible sin ver ningún código
• El concepto erróneo se enuncia y se desmonta explícitamente
• La pregunta del Gancho se responde explícitamente
• La Pantalla complementa la narración (sin texto duplicado)
• Leído en voz alta, suena a profesor, no a viñetas
• Las aperturas/cierres varían entre lecciones consecutivas

5 · Renderizar → master-class-render

Lee ~/.copilot/skills/master-class-render/SKILL.md y síguelo: escribe las escenas, luego construye los MP4, las notas de las lecciones y el MOC con un solo comando, luego verifica.

6 · Informe

Rutas (el MOC primero), número de lecciones y duración total, resultado de la corrección, cualquier cosa no verificada y un resumen del registro de lectura.