AI CodeOps

Agente Researcher

El agente Researcher estudia tu código, tus bibliotecas y tus referencias antes de empezar el trabajo, y resume los antecedentes y las restricciones. Abre Discovery & Spec.

El agente Researcher examina el terreno antes de que se decida nada. Estudia el código existente, las bibliotecas que usa el proyecto y las referencias relevantes, y después resume los antecedentes y las restricciones que importan para la tarea.

Dónde se ejecuta

Flujo de trabajoPaso
Discovery & SpecPrior art

Discovery & Spec es un flujo de trabajo de planificación para el inicio de un trabajo: investigación, después los requisitos del Product Analyst y después un plan por fases del Project Planner. El Researcher va primero.

Entradas

  • La tarea de la sesión.
  • Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto, elegidos para la tarea y dentro de un presupuesto de tamaño. Cuando el proyecto no tiene repositorio, trabaja solo a partir de la tarea.
  • Herramientas de los servidores MCP conectados, si la política de tu espacio de trabajo las permite. Es la única forma que tiene de llegar a fuentes externas al repositorio.

Salidas

Un resumen por escrito:

  • Qué parte de la base de código ya hace algo parecido, y dónde está.
  • Bibliotecas que ya se usan y se podrían reutilizar, y las que serían dependencias nuevas.
  • Restricciones que el trabajo debe respetar, como un modelo de datos existente o un patrón de autenticación.
  • Preguntas abiertas para las personas responsables de la decisión.

Los dos pasos siguientes lo leen. Con el nivel Auto, su paso va primero al nivel Premium.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. Matt ejecuta Discovery & Spec con «Añade sincronización bidireccional con nuestro gestor de incidencias». El Researcher informa de que el proyecto ya tiene un emisor de webhooks salientes y una cola de reintentos que podrían transportar los eventos de sincronización, de que todavía no hay ningún endpoint de webhooks entrantes y de que el cliente HTTP existente no gestiona los límites de peticiones. Señala la restricción de que los id de las incidencias se guardan como enteros mientras que el gestor usa strings, y pregunta si la sincronización debe ser por proyecto o por espacio de trabajo. Después, el Product Analyst escribe los requisitos con esos datos en la mano.

Límites

  • No navega por la web ni lee documentación de terceros salvo que se la proporcione una herramienta MCP.
  • Ve una selección de archivos, no el repositorio entero. En una base de código grande puede pasar por alto un módulo relevante.
  • Su conocimiento de las bibliotecas que no están en tu código es el del modelo, con la fecha de corte de entrenamiento de ese modelo.

Preguntas frecuentes

¿El agente Researcher busca en la web?

No. Lee el código del proyecto y se apoya en el conocimiento general del modelo. Solo puede llegar a otras fuentes mediante herramientas MCP que tu espacio de trabajo haya conectado y permitido.

¿Por qué investigar antes de los requisitos?

Para que los requisitos reutilicen lo que ya existe. Saber que ya hay un ejecutor de trabajos o un módulo de exportación cambia lo que se debe construir.