Descarga un laboratorio. Mantén tu trabajo separado.

Un ejercicio, un kit de aprendizaje, un workspace desechable. Empieza con el material que necesitas en lugar de clonar todos los lenguajes, instalar todas las dependencias o copiar la solución final del instructor.

[!TIP] ¿Primera visita? Elige 01 — Contexto e interfaz abajo. Necesitas Node 24 para sus pruebas locales; el acceso a Copilot es independiente. No se requiere un repositorio de GitHub ni una suscripción en la nube para el ejercicio local.

Qué contiene un kit

Los kits excluyen el directorio reference del instructor, el historial de Git, las dependencias, las cachés y los archivos del entorno local. No incluyen cuentas, runtimes ni credenciales. La lección y el código canónicos permanecen en inglés dentro del paquete; el sitio de aprendizaje también ofrece vistas de lectura en español y portugués brasileño. Las referencias oficiales externas siguen necesitando conexión a Internet.

[!IMPORTANT] Un starter no es una aplicación terminada. Algunas comprobaciones iniciales fallan de forma deliberada. Sigue el estado esperado en KIT-START.md; un runtime faltante, un error de importación o una ejecución de pruebas vacía no son una reproducción exitosa de un fallo intencional.

1. Selecciona y descarga

En el sitio de aprendizaje, un vínculo ZIP descarga el archivo directamente. En GitHub, si el vínculo abre una vista previa del archivo, selecciona Download raw file. Descarga el inventario de checksums correspondiente de la misma revisión inspeccionada.

Kits prácticos

Las cinco guías de preparación reutilizan el kit de ejercicio asociado; no necesitan cinco archivos duplicados. Elige la variante C# o Python para los laboratorios con pareja de lenguajes, no ambas a la vez.

Kits de aventura

Cada kit contiene el laboratorio, su verificador y las instrucciones de la aventura. Un verificador rechaza un ejercicio sin terminar salvo que la tabla indique lo contrario. El descubrimiento del host y las integraciones en vivo requieren evidencia separada.

2. Verifica y extrae en tu sistema

Elige un proyecto o unidad de trabajo existente con suficiente espacio. Las rutas siguientes son ejemplos: sustitúyelas por tu ubicación de trabajo aprobada. Nunca extraigas encima de un repositorio existente. En el Mac compartido del taller, usa la unidad de trabajo T9.

Compara el hash completo con la entrada de SHA256SUMS.txt. Un hash procedente de un archivo comprimido no confiable no autentica ese archivo. Revisa el repositorio y el origen de descarga antes de ejecutar cualquier código.

Abre la carpeta extraída y lee KIT-START.md. Especifica si VS Code debe abrir la raíz del kit o starter/. Usa Archivo → Abrir carpeta en una ventana nueva. No dejes otro repositorio en un workspace de varios roots.

Punto de control: puedes encontrar la fuente, la lección y el manifiesto en el disco fuera del visor del ZIP. Si Node 24 está instalado, node KIT-VERIFY.cjs desde la raíz del kit comprueba que la extracción conservó los archivos empaquetados.

3. Ejecuta solo la línea base seleccionada

1. Lee el requisito de runtime en KIT-START.md.
2. Selecciona el intérprete o SDK correspondiente. No instales todas las pilas de lenguaje.
3. Usa el directorio de trabajo impreso junto al comando de la línea base.
4. Registra el comando, las pruebas descubiertas, el código de salida y la salida real.
5. Compara el resultado con éxito esperado o fallo intencional del starter.
6. Continúa con KIT-LESSON.md: conceptos, Ask, Plan, Agent, comprobaciones negativas y revisión.

Las pruebas de contrato locales no necesitan autenticación de Copilot. Un agente en vivo, CLI, SDK o ejercicio en la nube puede requerir acceso a la cuenta y consumir uso. Mantenlo separado.

Usa VS Code o Insiders desde el kit extraído

1. Lee el valor del espacio de trabajo en KIT-START.md. Los kits prácticos se abren en la raíz del kit; las personalizaciones de las aventuras se abren en starter/.

2. Usa File > Open Folder (Archivo > Abrir carpeta) en la edición elegida, o abre un terminal en ese espacio de trabajo y ejecuta uno de los comandos del editor:

   code .
   

   Para usar Insiders en su lugar:

   code-insiders .
   

3. Comprueba la cuenta de GitHub y el perfil activos en esa edición. Revisa la Confianza del área de trabajo (Workspace Trust) y las personalizaciones incluidas antes de autorizar herramientas.

4. Sigue las etapas de Ask, Plan, Agent y revisión de la lección. Desde un terminal en el directorio starter/ de una aventura, el verificador está un directorio más arriba:

   node ../verify.js
   

   Si estás en la raíz del kit de la aventura:

   node verify.js
   

Estos dos comandos son alternativas según el directorio de trabajo, no dos pruebas diferentes. Los kits prácticos usan la comprobación inicial indicada en su propia guía de primera ejecución. No sustituyas una prueba específica del lenguaje por el verificador de una aventura.

Usa Copilot CLI desde el kit extraído

1. Completa la instalación y la autenticación de la CLI para tu sistema operativo. No es necesario instalar VS Code para trabajar con código solo desde el terminal.

2. Abre un terminal en la raíz del kit extraído. Para una aventura, entra primero en su directorio starter/; para un kit práctico, permanece en la raíz del kit:

   cd starter
   

   Ejecuta el comando de cambio de directorio solo para una aventura. Después, inicia el agente independiente:

   copilot
   

3. Usa primero el prompt de investigación de la lección sin hacer cambios. Después, solicita un plan con el alcance de archivos, comprobaciones positivas y negativas y el restablecimiento. Estas son responsabilidades, no una promesa de controles idénticos a los de VS Code en la CLI.

4. Aprueba únicamente el cambio revisado. No concedas acceso a todo el repositorio padre ni desactives las solicitudes de permiso para facilitar una prueba.

5. Mantén un terminal normal separado para las pruebas. Ejecuta los comandos de KIT-START.md desde el directorio indicado; no pegues comandos de prueba en el agente como si eso fuera un resultado ejecutado en el terminal.

6. Revisa el diff y las salidas reales. Si inicializaste Git en la raíz del kit, estos comandos de solo lectura muestran los cambios:

   git status --short
   git diff
   

7. Registra en tu evidencia la interfaz, la versión, los permisos y las limitaciones que realmente utilizaste. Sal de la sesión de aprendizaje cuando termines; no dejes un agente sin supervisión con amplias facultades.

El mismo proyecto inicial puede servir para diferentes entornos sin que sus capacidades sean intercambiables. No se necesita crédito de Azure para estas comprobaciones locales ni para la autenticación de GitHub Copilot CLI.

4. Crea un repositorio local, si hace falta

Ejecuta estos comandos dentro de la raíz del kit extraído, después de inspeccionar sus archivos:

git init -b training
git status --short

Revisa la lista de archivos. Excluye dependencias, archivos de entorno y datos de tiempo de ejecución en el .gitignore local antes de hacer staging. Si Git necesita una identidad, configúrala solo para este repositorio, con tu propio nombre y correo aprobados.

git config user.name "YOUR NAME"
git config user.email "YOUR APPROVED EMAIL"
git add .
git commit -m "Record untouched learning baseline"

Los dos valores de identidad son marcadores de posición, no comandos para copiar sin cambios. Crear esta línea base local no crea un repositorio en GitHub.

5. Publica opcionalmente en tu propio repositorio de GitHub

[!CAUTION] Publicar transfiere archivos a GitHub. Revisa las licencias y cada archivo en staging. Nunca subas credenciales, datos personales reales ni material privado del instructor. Un repositorio privado es un valor predeterminado sensato, no permiso para subir secretos.

1. Inicia sesión en GitHub con tu cuenta autorizada.
2. Selecciona New repository y elige un propietario que tengas permitido usar.
3. Introduce un nombre único de entrenamiento y elige la visibilidad adecuada.
4. Deja sin marcar la inicialización con README, licencia y .gitignore: el kit local ya tiene archivos y un commit.
5. Crea el repositorio vacío y copia su URL HTTPS.
6. En la raíz del kit, inspecciona git remote -v. Si ya hay un origin, detente y confirma qué repositorio identifica; no lo reemplaces automáticamente.
7. Añade la URL copiada y sube la rama de entrenamiento:

git remote add origin https://github.com/YOUR-OWNER/YOUR-TRAINING-REPOSITORY.git
git push -u origin training

Sustituye los marcadores de URL. Usa el flujo de autenticación aprobado por GitHub; no pongas un token de acceso en la URL ni en un documento. Comprueba la rama y los archivos en GitHub. Un encargo de agente en la nube o una pull request es una acción posterior, revisada por separado.

Finalizar, solucionar problemas y restablecer

• Conserva el archivo original como línea base limpia.
• Guarda el diff, las comprobaciones ejecutadas y las limitaciones.
• Detén solo los procesos y sesiones creados para el ejercicio.
• Extrae en un directorio nuevo y sin usar para otro intento.
• Cierra solo los recursos remotos propiedad del ejercicio después de revisar qué debe preservarse.

Reproducibilidad para mantenedores

Desde la copia del currículo, ejecuta npm run build:kits después de cambiar una lección empaquetada, un fixture o una imagen. npm run check:kits rechaza artefactos faltantes o desactualizados. El generador usa la biblioteca estándar de Node, entradas ordenadas, marcas temporales ZIP fijas, licencias incluidas, manifiestos de archivos e inventario SHA-256. Nunca ejecuta código del alumno. Esto es reproducibilidad para el formato de paquete declarado, no una certificación de seguridad.

Las entradas ZIP usan el método STORE sin compresión, de modo que las sumas de comprobación no dependen de la biblioteca de compresión del runtime. Los archivos son más grandes que los ZIP comprimidos, pero conservan los mismos archivos extraídos y bytes deterministas en los entornos compatibles.

Referencias oficiales

• Descargar archivos fuente
• Agregar código alojado localmente a GitHub
• Configurar Git
• Abrir un workspace de VS Code