Diseñador de Agentes

Estado: ✅ Disponible

El Diseñador de Agentes es un agente de herramientas integrado que genera un AgentSpec YAML válido a partir de una descripción en lenguaje natural. En vez de completar manualmente el asistente de creación de agentes, simplemente describes lo que necesitas en lenguaje sencillo y obtienes una especificación lista para usar en segundos.

Qué hace

El Diseñador de Agentes lee el contexto de tu espacio de trabajo — agentes existentes, habilidades instaladas y la pila tecnológica de tu proyecto — y produce una especificación que encaja naturalmente en la arquitectura de tu equipo. Hace lo siguiente:

Infiera el role, domain, expertise e intents correctos a partir de tu descripción
Evita colisiones con IDs de agentes existentes
Solo referencia habilidades que realmente están instaladas en el espacio de trabajo
Emite exactamente un bloque YAML con delimitadores — sin texto explicativo ni marcadores de posición

Cómo usarlo

Antes de invocar @agent-designer, instálalo desde el marketplace de este repositorio copiando los archivos empaquetados dentro de la carpeta .agent-teams de tu proyecto:

Copia marketplace/agents/agent-designer.yml en .agent-teams/agents/
Copia marketplace/skills/agent-spec-authoring/ en .agent-teams/skills/
Recarga Agent Teams o vuelve a abrir el dashboard para que detecte el nuevo agente y la nueva habilidad

Paso 1 — Invoca al agente en Copilot Chat o Claude

Dirígete al agente directamente con @agent-designer (Copilot) o menciónalo por nombre en tu conversación con Claude:

@agent-designer diseña un agente que revise pull requests de TypeScript en busca de problemas de seguridad y tests faltantes

Paso 2 — Describe lo que necesitas

Cuanto más contexto des, más preciso será el resultado. Puedes incluir:

Pista	Ejemplo
Rol	"un orquestador que coordina el pipeline de frontend"
Dominio	"un agente backend enfocado en servicios REST Node.js"
Capacidad principal	"revisa PRs", "genera documentación API", "ejecuta migraciones de base de datos"
Restricciones	"solo lectura, sin creación de archivos"
Habilidades a usar	"usa la habilidad search-codebase"

Consejo: No necesitas mencionar todos los campos. El agente infiere lo que puede del espacio de trabajo y deja vacíos los campos opcionales cuando no está seguro.

Paso 3 — Usa el YAML generado

El agente produce un solo bloque de código YAML. Puedes:

Copiar → Asistente de creación de agentes — pega el YAML en la pestaña Raw YAML dentro del asistente
Guardar directamente — coloca el archivo en .agent-teams/agents/tu-agente.yml y el dashboard lo detectará en el próximo refresco
Iterar — pide al agente que ajuste campos específicos: refina las restricciones para que también escale cuando se modifique una API pública

Ejemplo

Entrada:

@agent-designer crea un agente worker que revise pull requests en un proyecto backend con TypeScript + Node.js

Salida:

id: pr-reviewer
name: PR Reviewer
version: 1.0.0
role: worker
domain: backend
description: >
  Revisa pull requests para verificar corrección, seguridad y cobertura de tests en
  servicios Node.js con TypeScript. Deja comentarios estructurados y aprueba o
  solicita cambios.
expertise:
  - TypeScript
  - Node.js
  - Diseño de API REST
  - Revisión de código de seguridad
  - Análisis de cobertura de tests
intents:
  - review_pull_request
  - check_test_coverage
  - flag_security_issues
scope:
  topics:
    - revisión de pull requests
    - calidad de código
    - análisis de seguridad
  path_globs:
    - pattern: src/**/*.ts
      priority: high
    - pattern: '**/*.test.ts'
      priority: medium
  excludes:
    - dist/**
    - node_modules/**
workflow:
  - Lee el diff del PR e identifica archivos cambiados dentro del alcance.
  - Verifica tests faltantes o inadecuados para la lógica modificada.
  - Escanea problemas comunes de seguridad (inyección, bypass de auth, secretos en código).
  - Revisa contratos de API para cambios incompatibles.
  - Produce una revisión estructurada usando la plantilla de salida code-review.
tools:
  - name: github
    when: obteniendo el diff del PR y publicando comentarios de revisión
permissions:
  can_create_files: false
  can_edit_files: false
  can_delete_files: false
  can_run_commands: false
  can_delegate: false
  can_modify_public_api: false
  can_touch_global_config: false
constraints:
  always:
    - Señalar cualquier cambio que elimine o debilite controles de autenticación.
    - Requerir tests para cada nueva función exportada.
  never:
    - Aprobar un PR que introduzca secretos o credenciales hardcodeados.
    - Revisar archivos fuera del alcance definido.
  escalate:
    - Cuando un PR modifique contratos de API pública sin aumentar la versión.
output:
  template: code-review
  mode: detailed
  max_items: 10
targets:
  - copilot
  - claude

La habilidad agent-spec-authoring

La precisión del Diseñador de Agentes proviene de la habilidad agent-spec-authoring instalada en tu espacio de trabajo. Esta habilidad proporciona el esquema completo de AgentSpec — todos los campos válidos, tipos, reglas de validación y semántica de roles — para que el agente siempre produzca especificaciones que pasen la validación.

Campos requeridos

Campo	Tipo	Reglas
`id`	string	Slug: `^[a-z0-9-]+$`. Debe ser único en el espacio de trabajo.
`name`	string	Legible por humanos, 3–80 caracteres.
`role`	string	`worker` \| `orchestrator` \| `router` \| `aggregator`
`description`	string	1–3 frases, 10–600 caracteres.

Semántica de roles

Rol	Cuándo usarlo
`worker`	Ejecuta una tarea enfocada dentro de un alcance definido
`orchestrator`	Descompone un objetivo y delega sub-tareas a workers dentro de un dominio
`router`	Recibe solicitudes y las enruta al agente más adecuado mediante herramientas de despacho
`aggregator`	Fusiona los resultados de orchestrators en paralelo y reporta conflictos entre dominios

Campos opcionales comunes

Campo	Descripción
`domain`	Dominio principal: `frontend`, `backend`, `testing`, `tooling`, `devops`
`expertise`	Lista de áreas de conocimiento usadas para el enrutamiento
`intents`	IDs de acción en snake_case que maneja este agente (ej. `review_pull_request`)
`scope`	Globs de archivos, temas y exclusiones que definen el alcance operacional del agente
`workflow`	Pasos imperativos ordenados que sigue el agente
`skills`	IDs de habilidades del registro del espacio de trabajo
`tools`	Capacidades del entorno (`github`, `terminal`, etc.) con `when` opcional
`constraints`	Reglas de comportamiento `always` / `never` / `escalate`
`targets`	Plataformas a sincronizar: `copilot`, `claude` (por defecto: ambas)

Para la referencia completa del esquema incluyendo sub-objetos, consulta el archivo SKILL.md dentro de marketplace/skills/agent-spec-authoring/.

Restricciones

El Diseñador de Agentes aplica estas reglas en cada generación:

Siempre:

Emitir exactamente un bloque YAML con delimitadores — sin texto antes ni después
Usar solo campos definidos en el esquema AgentSpec
id debe coincidir con ^[a-z0-9-]+$ y no debe colisionar con IDs de agentes existentes
Cada intent debe coincidir con ^[a-z0-9_]+$ (snake_case)
Incluir los 4 campos requeridos: id, name, role, description
Referenciar solo habilidades disponibles en el espacio de trabajo

Nunca:

Inventar nombres de campos que no estén en el esquema
Emitir JSON en vez de YAML
Incluir prosa markdown fuera del bloque delimitado
Reutilizar un ID que ya exista en el espacio de trabajo

Qué hace​

Cómo usarlo​

Paso 1 — Invoca al agente en Copilot Chat o Claude​

Paso 2 — Describe lo que necesitas​

Paso 3 — Usa el YAML generado​

Ejemplo​

La habilidad agent-spec-authoring​

Campos requeridos​

Semántica de roles​

Campos opcionales comunes​

Restricciones​