Explorar la documentación

Pack Maker: crea y empaqueta tus propios agentes

Maker es un metaagente que diseña, valida y empaqueta nuevos agentes de BMAD+. Comando de instalación, las cuatro fases de creación, seis prompts, carpeta de salida y para qué sirve el paquete.

En esta página
  1. Cuándo usarlo
  2. Qué se instala
  3. Inicio rápido
  4. Ejemplos para copiar
  5. Qué escribe y dónde
  6. Flujos de datos y requisitos
  7. Límites y trampas

Maker es un agente que crea otros agentes. Describes lo que necesitas, Maker te guía por el perfil (persona), las capacidades, los disparadores de activación automática y las habilidades, te muestra una vista previa del diseño y solo entonces genera un paquete en el formato que BMAD+ espera. Es el pack para quien quiere un especialista que aún no existe, como un agente de soporte al cliente o un redactor de notas de versión, escrito con la misma forma que Atlas o Forge.

Cuándo usarlo

  • Necesitas un rol de especialista recurrente, con voz, reglas y menú propios, no un prompt puntual.
  • Quieres que se compruebe un archivo de agente existente antes de compartirlo (código VA).
  • Contribuyes agentes al propio BMAD+: el paquete incluye una guía de integración para el repositorio fuente.

Qué se instala

Un agente, Maker, en .agents/skills/agent-maker/ (un archivo de instrucciones y un manifiesto). El pack no tiene habilidades separadas ni archivo de datos. Su menú:

Menú de Maker
CódigoCapacidadQué pregunta o produce
CACreate Agent: creación guiada completaCuatro fases: descubrimiento, diseño validado por ti, generación, validación
QAQuick AgentDos preguntas (qué hace, nombre e icono), valores razonables para el resto
EAEdit AgentModifica en su sitio el SKILL.md de un agente existente
VAValidate AgentComprueba el formato, el manifiesto, la unicidad de los códigos de capacidad y la calidad de los disparadores
PAPackage AgentGenera la carpeta lista para integrar
TPShow TemplateMuestra la plantilla de agente de BMAD+

Las cuatro fases de Create Agent

  1. Descubrimiento: un lote de cinco preguntas: qué hace el agente, en qué dominio, si necesita varios roles, qué herramientas o API requiere, qué personalidad tiene.
  2. Diseño: una tabla de vista previa (nombre, perfil e icono, título, roles, nombre del pack, capacidades con códigos, disparadores, dependencias). No se genera nada hasta que lo apruebes; Maker itera hasta entonces.
  3. Generación: los archivos que se enumeran en la sección de salidas más abajo.
  4. Validación: una autocomprobación del formato, los campos del manifiesto, la definición del pack, la unicidad de los códigos de dos letras y la guía de integración, presentada como lista de verificación.

Inicio rápido

  1. Instalar el pack

    Core se añade automáticamente. Maker solo necesita Node.js 20 o superior para el instalador.

    En la terminal del proyecto
    npx bmad-plus install --packs maker

  2. Llamar a Maker con una descripción

    Cuanto más preciso sea el objetivo, menos preguntas tendrá que hacer.

    En la terminal del proyecto
    Maker, crea un agente de soporte al cliente.

  3. Revisar la vista previa del diseño y después el paquete

    Aprueba o corrige la tabla de vista previa. El paquete aparece en _bmad-output/ready-to-integrate/.

Ejemplos para copiar

Crear un agente con el flujo guiado completo (CA)

Úsalo cuando el agente necesita varios roles o herramientas y quieres controlar cada decisión.

En tu asistente de IA
Maker, crea un agente de soporte al cliente. Debe clasificar los tickets entrantes, redactar respuestas con tono sereno y escalar las disputas de facturación a una persona. Necesita acceso de lectura a los artículos de nuestro centro de ayuda. Dos roles: Triage y Reply.

Lo que deberías obtener Maker hace sus cinco preguntas de descubrimiento en un solo lote (tu petición ya responde a varias), muestra la tabla de vista previa del diseño y espera tu aprobación. Tras ella escribe el paquete en _bmad-output/ready-to-integrate/ y presenta la lista de verificación.

Crear rápido un agente pequeño (QA)

Úsalo para un agente de propósito único. Puedes afinar el resultado después.

En tu asistente de IA
Maker, quick agent: un redactor de notas de versión llamado Chronicle que convierte una lista de cambios fusionados en notas para los usuarios. Icono: un pergamino.

Lo que deberías obtener Solo se hacen dos preguntas (propósito, nombre e icono); el resto recibe valores razonables. Se generan los mismos archivos del paquete y después puedes pedir cambios.

Editar un agente existente (EA)

Indica a Maker la carpeta del agente y di qué debe cambiar. Edit Agent trabaja sobre el SKILL.md del agente allí donde ya está.

En tu asistente de IA
Maker, edita el agente de _bmad-output/ready-to-integrate/agents/agent-chronicle: añade una capacidad con código BR que redacte una sección de cambios incompatibles y precisa la descripción de su cabecera para que no se elija ante cualquier petición que solo mencione una actualización.

Lo que deberías obtener El SKILL.md del agente se modifica en su sitio, en la carpeta que indicaste, y Maker mantiene la regla de unicidad de los códigos de capacidad. Uno de sus principios es validar contigo antes de finalizar, así que espera un resumen del cambio para confirmar. El paquete no tiene un archivo de disparadores aparte: la forma en que se elige el agente sale de la descripción de su cabecera.

Validar un paquete de agente (VA)

Úsalo antes de compartir o aportar un agente, incluso uno que no se creó con Maker.

En tu asistente de IA
Maker, valida este paquete de agente: _bmad-output/ready-to-integrate/agents/agent-chronicle. Enumera cada problema y ofrece corregirlos uno por uno.

Lo que deberías obtener Un informe sobre cuatro puntos: conformidad del formato de SKILL.md, completitud del manifiesto, unicidad de los códigos de capacidad y calidad de los disparadores (suficientemente específicos o no). Cada problema viene con una oferta de corrección. Lee archivos; no ejecuta el agente.

Generar la carpeta lista para integrar (PA)

Úsalo cuando el diseño está cerrado y quieres los archivos en un solo lugar.

En tu asistente de IA
Maker, empaqueta el agente Chronicle para poder entregar la carpeta a un colaborador.

Lo que deberías obtener La carpeta _bmad-output/ready-to-integrate/ contiene agents/agent-chronicle/SKILL.md, agents/agent-chronicle/bmad-skill-manifest.yaml, pack-definition.yaml e INTEGRATION.md.

Ver la plantilla de agente antes de escribir uno (TP)

Úsalo para aprender la estructura esperada o para escribir un agente a mano.

En tu asistente de IA
Maker, muéstrame la plantilla de agente de BMAD+.

Lo que deberías obtener La plantilla de un SKILL.md de agente: cabecera con name y description, y las secciones Overview, Identity, Communication Style, Principles, Capabilities (código, descripción, habilidad) y On Activation.

Qué escribe y dónde

Archivos de un paquete generado
Archivo en _bmad-output/ready-to-integrate/Función
agents/agent-<name>/SKILL.mdEl agente: identidad, estilo, principios, capacidades, activación
agents/agent-<name>/bmad-skill-manifest.yamlManifiesto: nombre visible, título, icono, capacidades, rol, pack
pack-definition.yamlUna entrada lista para fusionar en la tabla packs: de registry.yaml (orden, nombre visible, icono, agentes, perfiles (personas), habilidades, modo de instalación)
INTEGRATION.mdPasos para integrar el agente en las fuentes de BMAD+

Flujos de datos y requisitos

Maker no necesita nada más que Core y Node.js 20 para el instalador: ni Python, ni clave, ni servicio de red propio. La creación y el empaquetado solo escriben en _bmad-output/ready-to-integrate/; Edit Agent modifica el SKILL.md de un agente existente allí donde se lo indiques. Los únicos datos que salen de tu máquina son los que tu herramienta de IA envía a su modelo, como con cualquier otro agente.

Límites y trampas

Advertencia El paquete apunta a las fuentes de BMAD+, no a tu proyecto instalado

El INTEGRATION.md generado te guía para añadir el agente al repositorio fuente de BMAD+: copiar la carpeta en src/bmad-plus/agents/, añadir la entrada de pack de pack-definition.yaml a registry.yaml (la fuente única de verdad), añadir la línea de ayuda a src/bmad-plus/module-help.csv, ejecutar npm run build y node tools/build/generate-adapters.js --adopt, y terminar con las comprobaciones de deriva (npm run build:check, generate-adapters --check --adopt, npm run check:counts). Sirve para aportar agentes al propio BMAD+; Maker no registra un agente nuevo en un proyecto que solo tiene BMAD+ instalado.

Nota La validación es una lectura de archivos

Las comprobaciones de Maker cubren formato, campos y unicidad. No prueban que el nuevo agente se comporte bien en la práctica; pruébalo con una tarea real antes de fiarte de él.

Nota Procedencia

Maker fue escrito por Laurent Rochetta, autor de BMAD+.

Véase también