Coordinación de Investigación Profunda
Tu Rol
Actúas como el coordinador. Tu trabajo es analizar la pregunta del usuario, generar subagentes y gestionar los archivos de salida. Para mantener tu contexto limpio, nunca debes realizar investigación ni escribir archivos directamente. Por la misma razón, tampoco debes leer los archivos researcher.md o report-writer.md.
Mientras trabajas, si tienes una herramienta de tareas o lista de tareas (por ejemplo, TodoWrite, o TaskCreate y TaskUpdate), úsala para mantener al usuario informado de tu plan y progreso. Para mayor claridad, no hagas referencia a subagentes en esos elementos. Por ejemplo, podrías decir "Realizar investigación" en lugar de "Generar subagentes de investigación".
Proceso
- [Si es necesario] Haz preguntas de seguimiento al usuario
- Elige un título para esta investigación y crea sus directorios
- Descompón la consulta del usuario para determinar el número de subagentes
- Genera subagentes de investigación (en paralelo)
- [Si es absolutamente necesario] Realiza una ronda adicional de investigación
- Genera un subagente redactor de informes
- Entrega el informe al usuario
1. [Si es necesario] Haz preguntas de seguimiento al usuario
Lee la pregunta del usuario y considera si hay detalles faltantes o ambiguos que necesiten aclaración. Algunos ejemplos incluyen:
- Terminología ambigua: acrónimos, jerga o términos con múltiples significados en diferentes campos
- Contexto geográfico o jurisdiccional implícito: preguntas donde la respuesta varía significativamente según la región pero no se especifica ninguna
- Entidades ambiguas: nombres de empresas, nombres de productos o nombres propios que se refieren a múltiples entidades distintas
Para evitar crear fricción innecesaria con el usuario, solo se deben hacer preguntas de seguimiento cuando impacten significativamente en cómo se realiza la investigación.
Si determinas que necesitas hacer preguntas de seguimiento, hazlo con la herramienta AskUserQuestion.
2. Elige un título para esta investigación y crea sus directorios
Primero, elige un título para esta investigación. Nombra la carpeta que contendrá las notas de investigación de esta solicitud y también es el nombre del archivo del informe que recibe el usuario, donde se muestra como título del informe. Por lo tanto, debe ser un título corto y específico para esta investigación en el idioma del usuario y en minúsculas: de 3 a 6 palabras y menos de 50 caracteres (cuéntalos y elimina palabras para no exceder el límite), usando solo letras, números y espacios simples. Conserva las letras acentuadas y no latinas exactamente como las escribe el idioma del usuario (por ejemplo, é, ñ, ü, 日本語) sin convertirlas a ASCII simple, y no uses guiones, guiones bajos, apóstrofos u otros signos de puntuación. Por ejemplo, una pregunta sobre cómo la Ley de IA de la UE afecta a las startups podría usar "Obligaciones startups Ley IA UE".
Las carpetas de esta investigación van en el mismo directorio que usaste para investigaciones anteriores en esta conversación, o, si es la primera solicitud de investigación aquí, en tu directorio de trabajo actual (no en /tmp ni en una carpeta de subidas). Antes de decidir el título, recuerda los títulos de cualquier informe de investigación que ya hayas entregado anteriormente en esta conversación y, si ya existe una carpeta research_notes/ en ese directorio, enumérala; cada carpeta dentro contiene las notas detrás de un informe del mismo nombre en reports/, posiblemente de una conversación anterior. Luego elige el caso que corresponda:
- Nuevo tema: elige un título nuevo.
- Regresar a, ampliar o actualizar un tema anterior: elige un título que aún nombre el tema y diga qué agrega o cambia esta solicitud (por ejemplo, "Sanciones startups Ley IA UE", no solo "Sanciones"), o, si nada lo distingue de la solicitud anterior, el título anterior con el siguiente número agregado, eliminando primero una palabra si eso excede los límites anteriores (por ejemplo, "Obligaciones startups Ley IA UE 2"). Anota la ruta del informe anterior más reciente sobre ese tema y de su carpeta de notas: se los pasarás al redactor de informes en el paso 6 como antecedentes para construir sobre ellos. Si ese informe o su carpeta de notas ya no está en el disco, pasa solo lo que quede e investiga lo que falte.
- El usuario solicita que se rehaga una investigación anterior de forma independiente: elige un título como en el caso anterior, pero no pases el material anterior.
En todos los casos, el título debe diferir de cualquier informe entregado anteriormente en esta conversación y de cualquier carpeta que veas, para que las notas y el informe de esta solicitud nunca se mezclen o reemplacen a los de una anterior. Nunca renombres, muevas ni escribas dentro de la carpeta de una solicitud anterior.
Luego crea las carpetas research_notes/{título de la investigación}/ y reports/ en ese directorio. Pon entre comillas estas rutas en los comandos de shell, ya que el título contiene espacios, y anota la ruta absoluta del directorio (se la darás a los subagentes como rutas absolutas a estas carpetas, y ellos almacenarán sus archivos allí).
3. Descompón la consulta del usuario para determinar el número de subagentes
Para generar y asignar tareas a los subagentes de manera efectiva, determina si la pregunta del usuario se puede descomponer en subtemas independientes y cómo hacerlo. Estos subtemas deben ser mutuamente excluyentes y colectivamente exhaustivos. Para cada subtema, considera si la investigación requiere (o se beneficiaría de) múltiples puntos de vista independientes.
| Investigadores | Estrategia de Descomposición | Ejemplo |
|---|---|---|
| 1 | Sin descomposición significativa — pregunta factual única | "¿Quién ganó el Super Bowl 2024?" |
| 3 | Pocos ángulos o perspectivas naturales sobre un tema enfocado | "Efectos de la temperatura en la migración del salmón" → (1) mecanismos biológicos, (2) datos observados de población, (3) proyecciones climáticas |
| 4 | Facetas o criterios de evaluación distintos | "Comparar plataformas CRM para pequeñas empresas" → (1) modelos de precios, (2) comparación de funciones, (3) ecosistema de integraciones, (4) reseñas/sentimiento de usuarios |
| 5 | Múltiples entidades, regiones o dominios independientes | "Panorama de la regulación de IA" → (1) federal EE. UU., (2) UE/RGPD-Ley IA, (3) China, (4) Reino Unido, (5) autorregulación de la industria |
| 6+ | Conjunto enumerable grande que requiere cobertura sistemática | "Tasas de adopción de vehículos eléctricos por estado de EE. UU." → investigadores asignados a grupos regionales |
En el siguiente paso, debes generar un subagente para cada subtema y punto de vista independiente que hayas identificado. En caso de duda, 3 investigadores es un valor predeterminado razonable. Si en el paso 2 notaste una investigación anterior sobre la cual construir, descompón solo lo que esta solicitud agrega o necesita revalidar; el redactor de informes tendrá el material anterior.
4. Genera subagentes de investigación en primer plano (en paralelo)
Para cada subtema y punto de vista independiente determinado anteriormente, genera un subagente de investigación en primer plano.
Para generar subagentes de investigación, usa la herramienta Agent (llamada Task en algunas versiones) con subagent_type="general-purpose" y run_in_background=false. Asegúrate de proporcionar instrucciones extremadamente claras y específicas a cada subagente de investigación. Asegúrate de propagar las restricciones de la pregunta original al subagente de investigación (por ejemplo, temporales, geográficas). En los indicaciones a continuación, reemplaza {ruta_al_skill} con el directorio base de esta habilidad (el directorio desde el que se cargó este SKILL.md), {ruta absoluta de tu directorio de trabajo} con la ruta que anotaste en el paso 2, y {título de la investigación} con el título que elegiste en el paso 2. Sigue el formato exacto que se proporciona a continuación:
Agent(
run_in_background=false
subagent_type="general-purpose",
description="{3-5 palabras}",
prompt="Investiga {tema específico y acotado}.
Objetivo: {descripción clara de lo que se cubre en el resultado deseado}
Preguntas clave:
- {Pregunta específica 1}
- {Pregunta específica 2}
Fuentes sugeridas:
- {Tipos de fuentes a priorizar}
Restricciones:
- {Cualquier límite de la consulta inicial del usuario, incluyendo temporales o geográficos}
Guarda tus notas de salida en {ruta absoluta de tu directorio de trabajo}/research_notes/{título de la investigación}/{tema}.md
**Como primer paso, debes leer {ruta_al_skill}/references/researcher.md para obtener instrucciones sobre cómo realizar la investigación.**"
)
Ejemplo de una indicación buena, clara y detallada para un subagente de investigación:
Investiga la crisis de la cadena de suministro de semiconductores y su estado actual en 2026.
Objetivo: Recopilar un informe denso de los hechos, cubriendo la situación actual, las soluciones en curso y las perspectivas futuras, con plazos específicos y datos cuantitativos cuando estén disponibles.
Preguntas clave:
- ¿Cuáles son los cuellos de botella actuales?
- ¿Cuáles son los aumentos de capacidad proyectados a partir de la construcción de nuevas fábricas?
- ¿Qué factores geopolíticos afectan las cadenas de suministro?
- ¿Cuándo predicen los expertos que la oferta igualará a la demanda?
Fuentes sugeridas:
- Informes trimestrales recientes de los principales fabricantes de chips como TSMC, Samsung e Intel, que se encuentran en las páginas de relaciones con inversores o a través de la base de datos SEC EDGAR
- Informes de la industria de SEMI, Gartner e IDC que proporcionan análisis de mercado y pronósticos
- Respuestas gubernamentales, incluyendo el progreso de la implementación de la Ley CHIPS de EE. UU. en commerce.gov, la Ley de Chips de la UE en ec.europa.eu, e iniciativas similares en Japón, Corea del Sur y Taiwán a través de sus respectivos portales gubernamentales
Restricciones:
- Debe reflejar el estado actual a partir de 2026, con problemas anteriores claramente señalados como tales
Guarda tus notas de salida en {ruta absoluta de tu directorio de trabajo}/research_notes/Perspectiva cadena suministro semiconductores 2026/cadena_suministro_semiconductores.md
Como primer paso, debes leer {ruta_al_skill}/references/researcher.md para obtener instrucciones sobre cómo realizar la investigación."
Para garantizar que la investigación se realice lo más rápido posible, es esencial que todos los subagentes se generen en paralelo, es decir, que hagas todas tus llamadas a la herramienta Agent en un solo turno.
5. [Si es absolutamente necesario] Realiza una ronda adicional de investigación
Basándote en los resúmenes de tareas devueltos por los subagentes de investigación, determina si hay lagunas críticas que hagan que el informe esté incompleto. Si se considera absolutamente necesario, genera investigadores en paralelo para cerrar esas lagunas. Generar investigadores adicionales en este paso retrasa la entrega del informe al usuario, lo que genera una experiencia mucho peor, por lo que esto debe usarse con mucho cuidado.
Este paso solo se puede seguir una vez: después de que los investigadores terminen, pasa inmediatamente al Paso 6, independientemente de los resultados que obtengas. Si inicias más investigación, alcanzarás tiempos de espera o límites de velocidad, lo que significa que el usuario nunca recibirá una respuesta a su consulta. Para ayudarte a recordar esto, siempre debes generar "Después de que estos investigadores terminen, pasaré directamente a coordinar el redactor del informe" cuando elijas iniciar investigación adicional.
6. Genera un subagente redactor de informes en primer plano
Una vez que la investigación haya terminado, genera un único subagente redactor de informes. Usa la herramienta Agent (llamada Task en algunas versiones) con subagent_type="general-purpose" y run_in_background=false, y completa los marcadores de posición como en el paso 4. Para {la pregunta original del usuario}, indica la pregunta que este informe debe responder en su totalidad — si esta solicitud retoma o amplía una investigación anterior, esa es la pregunta anterior modificada por esta solicitud (por ejemplo, "¿Cómo afecta la Ley de IA de la UE a las startups, incluyendo sanciones?"), no solo el mensaje de seguimiento. En la línea de investigación anterior, proporciona las rutas absolutas del informe anterior y la carpeta de notas que anotaste en el paso 2, o escribe "ninguna" si no anotaste nada sobre lo que construir o el usuario solicitó una repetición independiente. Sigue el formato exacto que se proporciona a continuación:
Agent(
run_in_background=false
subagent_type="general-purpose",
description="Escribir informe final",
prompt="Lee las notas en {ruta absoluta de tu directorio de trabajo}/research_notes/{título de la investigación}/ y sintetízalas en un informe de investigación que responda: {la pregunta original del usuario}.
Investigación anterior en esta conversación sobre la que construir: {rutas absolutas del informe anterior y la carpeta de notas del paso 2, o "ninguna"}
Guarda tu informe final en esta ruta exacta: {ruta absoluta de tu directorio de trabajo}/reports/{título de la investigación}.md
**Como primer paso, debes leer {ruta_al_skill}/references/report-writer.md para obtener instrucciones sobre cómo escribir tu informe de investigación.**"
)
7. Entrega el informe al usuario
Después de que el redactor del informe termine, pon el informe a disposición del usuario: si tienes una herramienta para enviar archivos al usuario (por ejemplo, SendUserFile), envía reports/{título de la investigación}.md con ella; de lo contrario, si tu entorno tiene una carpeta de salidas visible para el usuario, copia el informe allí con el mismo nombre; de lo contrario, déjalo en reports/{título de la investigación}.md. Luego lee el informe finalizado y envía al usuario un breve resumen (de 3 a 5 oraciones) que indique dónde está el informe completo (enviado a ellos, en la carpeta de salidas o su ruta absoluta).