| name | generar-actas |
| description | Completa el Excel de actas descargado del campus virtual calculando la nota final a partir de múltiples ficheros de notas en CALIFICACIONES/<Grupo>/ConsolidacionNotas y sus ponderaciones en consolidacion.md, generando un fichero .xlsx terminado en -Cumplimentadas. Úsame cuando el usuario quiera generar actas a partir de las notas consolidadas. |
Skill: Generar Actas
Reparto de responsabilidades
- Este
SKILL.md es el contrato operativo de la skill.
- El workflow
/.agents/workflows/03-generar-actas.md describe el orden global del proceso.
- El script
scripts/generar_actas.py contiene la automatización principal.
Cuándo usar esta skill
- El usuario quiere completar actas descargadas del campus virtual.
- Ya existen las calificaciones en
CALIFICACIONES/<Grupo>/ConsolidacionNotas.
Cuándo NO usar esta skill
- Para corregir entregas y calcular notas provisionales.
- Para generar o validar el corrector.
- Para empaquetar recursos o correctores.
Procedimiento
1. Estructura esperada
La skill debe trabajar con esta estructura lógica:
CALIFICACIONES/<Grupo>/ConsolidacionNotas/CALIFICACIONES/<Grupo>/ConsolidacionNotas/<fichero_de_actas_descargado_del_campus_virtual>CALIFICACIONES/<Grupo>/ConsolidacionNotas/consolidacion.md
2. Preparación inicial
- Verificar si existe
CALIFICACIONES/<Grupo>/ConsolidacionNotas.
- Si no existe, detenerse y pedir al profesor que la cree, suba las notas necesarias y el fichero original del acta.
- Verificar si existe
consolidacion.md en esa carpeta.
- Si no existe, preguntar las ponderaciones al profesor y crear el fichero
consolidacion.md con una tabla Markdown estandarizada (Fichero, Ponderacion).
3. Estructura de consolidacion.md
El fichero consolidacion.md debe estar en la carpeta CALIFICACIONES/<Grupo>/ConsolidacionNotas/.
Debe contener una tabla Markdown con las siguientes columnas:
| Fichero | Ponderacion | Minimo | Hoja | Columna |
|---|
| tests.xls | 0.3 | | Calificaciones | Nota |
| notasLlopis.xlsx | 0.2 | | | |
| notas_definitivas.xlsx | 0.5 | 4 | | |
Fichero: nombre del fichero que contiene las notas (debe estar en el mismo directorio).Ponderacion: el peso numérico de esa parte (usar . o , para decimales).Minimo (opcional): si se especifica, el alumno debe obtener al menos esa nota en esa parte, o de lo contrario, su nota final de la asignatura será esa nota mínima (suspensa).Hoja (opcional): el nombre de la pestaña/hoja dentro del fichero Excel donde están las notas. Si está vacío, se buscará una hoja "Resultados" o se usará la primera.Columna (opcional): el nombre exacto de la columna donde está la nota. Si está vacío, se buscará la columna por defecto (nota, nota_total).
4. Columnas de interés del acta
Las columnas que se deben localizar y completar son:
- nombre del estudiante,
- número de identificación (DNI),
- nota numérica,
- calificación del alumno.
La localización debe tolerar variaciones razonables de mayúsculas, acentos y espacios.
4. Reglas de cumplimentación
- La nota numérica debe escribirse con un único decimal.
- En la columna calificación del alumno:
- escribir
MH si la nota es >= 9.5;
- escribir
SP si el alumno no tiene nota;
- dejar en blanco el resto.
5. Cruce con calificaciones
- El script
generar_actas.py se encargará de leer consolidacion.md y extraer la nota final ponderada por cada DNI a partir de los archivos de notas, porcentajes y mínimos aplicables indicados en consolidacion.md.
- Si un alumno no aparece en absoluto o no tiene nota final válida, tratarlo como sin nota (
SP).
6. Ficheros de salida
- Guardar el resultado dentro de la misma carpeta
ConsolidacionNotas/.
- Usar el mismo nombre base del fichero de actas original terminado en
-Cumplimentadas.xlsx.
- Generar un segundo archivo
notas-consolidadas.xlsx que incluirá el DNI, Nombre, todas las notas individuales y una columna final con la fórmula de cálculo de Excel para la nota final, formateado como tabla.
7. Script auxiliar
La automatización principal debe apoyarse en:
Ese script debe encargarse de:
- localizar el fichero de actas en
ConsolidacionNotas/;
- leer
consolidacion.md;
- leer y ponderar las notas de cada fichero Excel/CSV mencionado, respetando las condiciones de nota mínima indicadas en el mismo fichero, si las hubiera;
- detectar columnas en el acta y extraer los nombres asociados a los DNIs;
- escribir las notas finales ponderadas y calificaciones en el acta;
- guardar el acta resultante como
-Cumplimentadas.xlsx;
- generar
notas-consolidadas.xlsx con la fórmula de cálculo en Excel explícita por alumno.
Verificación
