Awesome CopilotAdventures

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

  1. Ejecuta el verificador sin modificar y registra el estado inicial esperado.
  2. Pide una explicación fundamentada en las fuentes del código y las comprobaciones relevantes.
  3. 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.
  4. Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
  5. 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.
  6. 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.

Buscar

Búsqueda en español. Las rutas y los ejemplos ejecutables conservan el texto original.