Laboratorio Las skills de Algora
[!TIP] Descarga el ZIP del alumno o copia todo este laboratorio en una carpeta sin usar. Lee la configuración y los pasos opcionales de GitHub primero.
Antes de ejecutar nada
| Elemento | Contrato |
|---|---|
| Runtime | Node 24; las integraciones en vivo son independientes |
| Archivos a revisar | starter/.github/skills/evidence-report/SKILL.md, verify.js |
| Directorio del verificador | Raíz del kit extraído: node verify.js; desde starter/: node ../verify.js |
| Estado inicial | Se rechaza un starter sin terminar; conserva el diagnóstico |
| Evidencia final | El archivo tiene metadatos válidos, un caso de uso acotado y ninguna instrucción para inventar resultados exitosos. |
Concepto en la práctica: Una skill de informe de evidencia resulta útil después de un cambio de código con un comando de pruebas. Una solicitud para pensar un nombre no debería activar un informe de verificación falso solo porque la skill exista.
Construye una skill pequeña y reutilizable para informes de finalización basados en evidencia primero.
Aísla el ejercicio
Copia este laboratorio a una ubicación desechable y abre starter/ como raíz del espacio de trabajo. Inicia una nueva sesión para que la skill se descubra en .github/skills/.
Misión
Completa starter/.github/skills/evidence-report/SKILL.md:
- conserva el frontmatter YAML con
nameydescription; - añade pasos para ejecutar la verificación solicitada;
- exige registrar el comando, el código de salida y el resultado observado;
- prohíbe afirmaciones de éxito sin respaldo.
Desde starter/, ejecuta node ../verify.js. Registra evidencia separada de que el harness seleccionado descubrió o invocó la skill.
Ejecución guiada
- Ejecuta el verificador sin modificar y registra el estado inicial esperado.
- Pide una explicación fundamentada en las fuentes del código y las comprobaciones relevantes.
- Planifica: define cuándo el informe de evidencia es relevante y cuándo no. Especifica el procedimiento para ejecutar una comprobación existente e informar la salida real, incluidas las comprobaciones bloqueadas o fallidas.
- Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
- Elimina el requisito de resultado observado y confirma que la comprobación estructural lo rechaza. Restaura la regla y compara una solicitud dentro del alcance con una fuera de alcance.
- Revisa el diff y registra la limitación: el verificador comprueba el contenido de la skill; el descubrimiento e invocación reales dependen del harness seleccionado.
Finalización y restablecimiento seguro
- El comportamiento requerido y su caso negativo cuentan con evidencia observada.
- El resultado distingue la verificación local del comportamiento en vivo del host/runtime.
- No se cambiaron credenciales, archivos no relacionados ni servicios.
- La evidencia está guardada antes de restablecer el starter copiado.
Usa una nueva extracción para otro intento, o restaura solo los archivos nombrados desde una línea base de Git creada en esta copia. Nunca apliques un comando de restablecimiento de la raíz del currículo desde un proyecto ajeno.
Continúa con la aventura y la rúbrica.