Laboratorio Los agentes de Stellaris
[!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/agents/test-scout.agent.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 perfil tiene búsqueda y una herramienta de comando enfocada, no una herramienta de edición, y un prompt de handoff concreto. |
Concepto en la práctica: Un test scout puede inspeccionar y ejecutar una prueba acotada, y luego recomendar un caso que falta. Un implementador distinto es dueño de las ediciones de código; el handoff transfiere un plan revisado, no autoridad ilimitada.
Define un agente personalizado enfocado usando el formato actual de personalización .agent.md.
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 .github/agents/test-scout.agent.md se descubra desde la raíz correcta.
Misión
Completa starter/.github/agents/test-scout.agent.md. Debe incluir campos de frontmatter para name, description y tools, e indicar después al agente que:
- inspeccione las pruebas existentes antes de recomendar cambios;
- mantenga un acceso de solo lectura respecto a las ediciones del código fuente y recomiende únicamente cambios centrados en pruebas;
- ejecute el comando de pruebas pertinente más pequeño;
- informe de la evidencia y de los fallos restantes.
- transfiera un plan de pruebas concreto al rol integrado Agent para su implementación.
Desde starter/, ejecuta node ../verify.js. Registra evidencia separada de que el agente aparece en el harness seleccionado y de que su handoff está disponible donde se admite.
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 los metadatos de test-scout y una lista mínima de herramientas coherente con el verificador. Mantén las recomendaciones centradas en pruebas, conserva la intención de solo lectura del código fuente y exige un handoff revisado a Agent.
- Implementa solo el fragmento aprobado y luego vuelve a ejecutar el mismo verificador.
- Añade temporalmente una herramienta de edición al perfil copiado. Verifica el rechazo y luego restaura la lista restringida de herramientas.
- Revisa el diff y registra la limitación: una herramienta de comando aún puede tener efectos secundarios. La intención de solo lectura no es un sandbox; revisa los comandos de prueba exactos y los permisos.
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.