10.3 Tu primer subagente (30–40 minutos)

Qué aprenderás: a crear, probar y ajustar un subagente de revisión de borradores.

Qué necesitas: un asistente de programación con agentes instalado y una carpeta de prueba con uno o dos textos tuyos (unos apuntes, un borrador de trabajo) sin datos personales.

Paso 1 · Crea el archivo del subagente

En tu carpeta de prueba, crea la carpeta de agentes de tu herramienta (consulta su documentación para saber cómo se llama y dónde va) y dentro un archivo llamado revisor-de-borradores.md con este contenido:

---
name: revisor-de-borradores
description: Revisa un borrador con ojos nuevos y devuelve un informe de problemas de estructura, claridad y datos por comprobar. Úsalo de forma proactiva cuando se termine de escribir un borrador. Indícale exactamente qué archivo debe revisar.
tools: leer archivos, buscar archivos, buscar texto
model: ligero
---

Eres un revisor exigente pero amable. Lees el borrador que se te indique y NO lo modificas.

Entrega siempre el informe con este formato:

1. Resumen: de qué trata el texto y tu valoración general en dos frases.
2. Problemas graves: lo que debe corregirse sí o sí (estructura, ideas que no se entienden, contradicciones).
3. Mejoras: sugerencias que harían el texto más claro.
4. Datos por comprobar: fechas, nombres, cifras o citas que el autor debería verificar en otra fuente.
5. Puntos fuertes: lo que funciona bien.
6. Obstáculos encontrados: cualquier problema que hayas tenido al revisar (archivo ilegible, texto incompleto…).

Cuando hayas rellenado las seis secciones, termina.

Alternativa: también puedes pedirle a tu asistente que escriba el archivo por ti describiéndole lo que quieres, o crearlo desde el asistente de creación de agentes de tu herramienta si lo incluye. Los campos obligatorios suelen ser name y description; los nombres de los campos, de las herramientas y de los modelos cambian según la herramienta, así que adapta el ejemplo a la tuya.

Paso 2 · Pruébalo

Abre tu asistente de programación en la carpeta y escribe:

Usa el subagente revisor-de-borradores para revisar mi-borrador.md.

(También puedes mencionarlo directamente con @ si tu herramienta lo permite.)

Paso 3 · Observa

• ¿Qué te devolvió? ¿Seguía el formato?
• ¿Qué no puedes ver de todo lo que hizo para llegar ahí? (Es el coste de delegar.)
• ¿Fue útil como «ojos nuevos»?

Paso 4 · Ajusta y vuelve a probar

• Si no se activa cuando esperas, mejora la descripción (más concreta, con ejemplos de cuándo usarlo).
• Si devuelve demasiado o es vago, mejora el formato de salida.
• Si toca lo que no debe, recorta las herramientas.

Reflexión: ¿Qué parte del trabajo habría sido peor delegar? ¿Por qué?