Laboratorio La convergencia de los tres reinos
[!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/workflow.json, 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 grafo conserva hallazgos, diseño, verificación, pull request, informe de evaluación y decisión humana en orden. |
Concepto en la práctica: Un desarrollador local, un trabajador en la nube y un agente de runtime embebido tienen identidades y salidas distintas. El mantenedor final necesita tanto la evidencia de implementación como la evaluación en runtime antes de decidir.
Conecta el desarrollo local, el trabajo en el repositorio remoto y un runtime embebido en un único grafo de entrega trazable.
Misión
Completa starter/workflow.json con seis etapas ordenadas:
| Fase | Actor | Rol de agente | Harness | Destino | Entorno | Superficie de revisión |
|---|---|---|---|---|---|---|
| Ask | Estudiante | ask |
vscode-local |
local |
repository-folder |
— |
| Plan | Estudiante | plan |
vscode-copilot |
copilot |
repository-folder |
— |
| Implementación | GitHub Copilot | agent |
vscode-copilot |
copilot |
worktree |
— |
| Implementación en la nube | GitHub Copilot | agent |
github-copilot-cloud-agent |
cloud |
ephemeral-github-environment |
— |
| Evaluación en tiempo de ejecución | Aplicación del SDK | custom-agent |
github-copilot-sdk |
application |
application-runtime |
— |
| Revisión | Responsable de mantenimiento | ninguno | no corresponde | no corresponde | no corresponde | github-pull-request |
Cada etapa debe declarar el actor por separado de:
- el rol de agente, cuando intervenga un agente;
- el harness;
- el destino;
- el entorno;
- los artefactos que consume;
- su límite de confianza;
- al menos un elemento concreto de evidencia.
La etapa de revisión humana deja intencionalmente en null las dimensiones exclusivas de los agentes, en lugar de hacer pasar una pull request por un harness o un entorno.
Ejecuta:
node verify.js
Usa artefactos en papel cuando no haya acceso al agente en la nube o al SDK. Etiqueta la alternativa de reserva en lugar de fabricar evidencia de ejecución.
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: completa el contrato de seis etapas usando las dimensiones de actor y artefacto suministradas. Explica cada arista consume/produce, límite de confianza y elemento de evidencia. Mantén los campos solo para agente en null para la revisión humana.
- Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
- Dale a la etapa de revisión humana un harness de agente y confirma que el verificador rechaza la confusión. Restaura el límite de revisión distinto.
- Revisa el diff y registra la limitación: completar el contrato del flujo de trabajo no es una entrega de producción. Registra las etapas en la nube y del SDK no ejecutadas como alternativas en papel, nunca como observaciones fabricadas.
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.