Fldicoahkiin/lab-report-autopilot

Lab Report Autopilot

Lleva el informe desde la asignación hasta la entrega: inspecciona los archivos, elige el entorno, ejecuta el experimento, captura los resultados útiles, rellena la plantilla del usuario e inspecciona el DOCX terminado. Una vez que los archivos requeridos y los campos personales están disponibles, continúa sin pedir al usuario que realice pasos rutinarios.

Nunca inventes resultados de software, capturas de pantalla, datos del usuario, citas o valores del entorno. Interrumpe solo cuando un entorno no disponible, una autorización faltante o un campo obligatorio ausente harían que el informe fuera falso.

Configuración

Resuelve el directorio que contiene este SKILL.md como SKILL_DIR. Ejecuta los scripts incluidos mediante la ruta absoluta; el directorio actual puede ser la carpeta de informes del usuario y no la carpeta de la habilidad.

Si no existe un espacio de trabajo para el informe:

python3 "$SKILL_DIR/scripts/init_report.py" work/report-name \
  --kind lab \
  --discipline packet-analysis \
  --title "ARP 协议抓包与字段分析"

Usa --kind practice para prácticas profesionales. Un DOCX suministrado sigue siendo la plantilla del informe; no lo reemplaces con el borrador genérico en Markdown.

El verificador de imágenes necesita Pillow:

python3 -m pip install -r "$SKILL_DIR/requirements.txt"

Leer el material

Clasifica cada entrada antes de escribir:

• Plantilla: controla secciones, campos, diseño de página y estilo visual.
• Buena referencia: muestra una longitud de paso, redacción o ubicación de captura de pantalla útil.
• Contraejemplo: muestra problemas que evitar.
• Material de la tarea: proporciona los datos, código, topología y resultado esperado requeridos.
• Material privado: sigue las instrucciones de manejo del usuario y proporciona solo hechos autorizados. Lee user-data-and-privacy.md.

Aprende el patrón, no la identidad o los resultados de otra persona. No copies nombres, capturas de pantalla, direcciones, registros privados ni afirmaciones en primera persona.

Lee disciplines.md, luego carga el archivo de disciplina correspondiente. Carga un segundo solo cuando la asignación realmente abarque varias materias.

Decidir qué se debe entregar

Registra:

• secciones requeridas y indicaciones de calificación;
• campos que el usuario ha proporcionado;
• software, sistema operativo, datos, topología y resultado esperado;
• el resultado visible necesario para cada afirmación presentada;
• reglas de longitud, fecha, nombre de archivo y formato de archivo.

Rellena nombres, números de estudiante, clase, profesor, organización, rol, fechas y otros campos solo con valores que el usuario proporcione o confirme. Usa el mismo valor en todas partes donde aparezca. Pregunta una vez por los campos obligatorios que la plantilla requiera. Deja los campos de firma, puntuación y aprobación vacíos a menos que el usuario los proporcione explícitamente. No reutilices un patrón de nombre de archivo de un informe no relacionado.

Antes de editar Word, lee docx-qa.md y mide la plantilla suministrada: tamaño de papel, márgenes, tablas, fuentes, tamaños, interlineado, sangrías, anchos de imagen, leyendas, encabezados, pies de página y numeración de páginas. Estos valores medidos controlan la salida.

Elegir el entorno

Lee environment-playbook.md, luego inspecciona la máquina actual:

python3 "$SKILL_DIR/scripts/probe_environment.py" --json

No asumas el ordenador del autor ni el producto de virtualización. Sigue el sistema operativo y el software nombrados por la asignación. Para trabajos comunes de cursos universitarios chinos, trata Windows como la ruta principal para Office, PowerShell, SQL Server, eNSP, simuladores de proveedores y software educativo exclusivo de Windows. Usa Linux o Kali para herramientas de redes y seguridad de Linux. Usa macOS de forma nativa solo cuando el software nombrado y las capturas de pantalla requeridas sigan siendo equivalentes; de lo contrario, usa cualquier VM Windows o Linux disponible, contenedor, WSL o laboratorio remoto autorizado.

Mantén las correcciones de permisos y los intentos fallidos en notas de trabajo a menos que cambien el resultado presentado. El trabajo de seguridad debe permanecer dentro de laboratorios locales, sistemas del curso, objetivos deliberadamente vulnerables u otros sistemas autorizados.

Ejecutar y capturar

Lee evidence-and-screenshots.md y el archivo de disciplina seleccionado.

1. Construye la configuración más pequeña que satisfaga la tarea.
2. Ejecuta cada comando y ruta de código que aparecerá en el informe.
3. Después de una acción GUI significativa, inspecciona el estado fresco de la aplicación.
4. Registra las entradas exactas, nombres de archivo, versiones, direcciones, números de trama y valores observados.
5. Captura la pantalla que muestra el resultado; no captures cada clic.
6. Mantén las capturas de pantalla originales, archivos de paquetes, datos y código fuente sin cambios.

Los diagramas generados pueden explicar un concepto, pero no pueden sustituir un resultado real de software. Las capturas de pantalla utilizadas en un informe deben coincidir en nombres de archivo, direcciones, puertos, valores y entorno.

Revisa la carpeta de imágenes antes de redactar:

python3 "$SKILL_DIR/scripts/evidence_manifest.py" path/to/evidence \
  --output evidence-manifest.json

Corrige archivos corruptos, duplicados accidentales, capturas ilegibles, datos privados expuestos y capturas de resultados faltantes.

Escribir a partir del resultado observado

Lee writing-and-code.md.

Para cada paso práctico, indica la operación, el valor o comportamiento observado, la captura de pantalla cercana y una breve explicación solo cuando sea útil. Mantén la teoría y los resúmenes proporcionales a los ejemplos y la asignación.

Para prácticas profesionales, escríbelo como trabajo asignado: qué se recibió, qué se verificó u operó, cómo se realizó el juicio y qué resultado se registró. No añadas notas de presentación sobre el número de capturas de pantalla, la estructura del informe, los artefactos retenidos o lo que el informe decide no introducir. No añadas una página de inicio de la empresa solo para llenar una línea de fuente.

Para código, implementa solo el comportamiento solicitado. No añadas abstracciones no utilizadas, opciones especulativas, comprobaciones de casos imposibles ni comentarios que repitan código simple.

Construir y verificar el DOCX

Usa las herramientas de documentos del agente anfitrión cuando estén disponibles; de lo contrario, usa herramientas DOCX compatibles y un renderizador real. Rellena la plantilla suministrada en su lugar. Elimina el texto de muestra solo donde el contenido del informe lo reemplace.

Renderiza el último DOCX e inspecciona cada página al 100%:

• las capturas de pantalla y leyendas son legibles y están alineadas;
• el texto, las tablas y las imágenes no se recortan ni se superponen;
• los glifos chinos y latinos se renderizan correctamente;
• los encabezados, la numeración, el espaciado, las sangrías, los márgenes, los encabezados y pies de página coinciden con la plantilla;
• los nombres, fechas, comandos, direcciones, números de trama, figuras y conclusiones concuerdan;
• no quedan páginas en blanco adicionales ni páginas casi vacías arrastradas;
• el nombre de archivo sigue la regla de esta asignación;
• no quedan credenciales, datos privados del lugar de trabajo ni información personal no relacionada.

Repite el renderizado después de cada cambio de diseño. Entrega solo los archivos solicitados a menos que el usuario pida material de trabajo.