Dokumentation durchsuchen

Maker-Pack: eigene Agenten bauen und paketieren

Maker ist ein Meta-Agent, der neue BMAD+-Agenten entwirft, validiert und paketiert. Installation, die vier Erstellungsphasen, sechs Prompts, Ausgabeordner und wofür das Paket gedacht ist.

Auf dieser Seite
  1. Wann du es brauchst
  2. Was installiert wird
  3. Schnellstart
  4. Beispiele zum Kopieren
  5. Was es schreibt und wo
  6. Datenflüsse und Voraussetzungen
  7. Grenzen und Stolpersteine

Maker ist ein Agent, der andere Agenten erstellt. Du beschreibst, was du brauchst; Maker führt dich durch Persona, Fähigkeiten, automatische Aktivierungs-Trigger und Skills, zeigt eine Entwurfsvorschau und erzeugt erst dann ein Paket im von BMAD+ erwarteten Format. Es ist das Pack für alle, die einen Spezialisten brauchen, den es noch nicht gibt, etwa einen Kundensupport-Agenten oder einen Release-Notes-Autor, in derselben Form wie Atlas oder Forge.

Wann du es brauchst

  • Du brauchst eine wiederkehrende Spezialistenrolle mit eigener Stimme, Regeln und Menü, keinen einmaligen Prompt.
  • Du willst eine vorhandene Agentendatei auf Formatprobleme prüfen lassen, bevor du sie teilst (Code VA).
  • Du steuerst Agenten zu BMAD+ selbst bei: Das Paket enthält eine Integrationsanleitung für das Quell-Repository.

Was installiert wird

Ein Agent, Maker, in .agents/skills/agent-maker/ (eine Anweisungsdatei und ein Manifest). Das Pack hat weder eigene Skills noch eine Datendatei. Sein Menü:

Maker-Menü
CodeFähigkeitWas sie fragt oder erzeugt
CACreate Agent: vollständig geführte ErstellungVier Phasen: Erkundung, Entwurf mit deiner Freigabe, Erzeugung, Validierung
QAQuick AgentZwei Fragen (was er tut, Name und Icon), sinnvolle Vorgaben für den Rest
EAEdit AgentÄndert die SKILL.md eines vorhandenen Agenten an Ort und Stelle
VAValidate AgentPrüft Format, Manifest, eindeutige Fähigkeitscodes und Trigger-Qualität
PAPackage AgentErzeugt den integrationsfertigen Ordner
TPShow TemplateZeigt die BMAD+-Agentenvorlage

Die vier Phasen von Create Agent

  1. Erkundung: ein Block mit fünf Fragen: was der Agent tut, welche Domäne, ob er mehrere Rollen braucht, welche Werkzeuge oder APIs, welche Persönlichkeit.
  2. Entwurf: eine Vorschautabelle (Name, Persona und Icon, Titel, Rollen, Pack-Name, Fähigkeiten mit Codes, Trigger, Abhängigkeiten). Nichts wird erzeugt, bevor du zustimmst; Maker iteriert, bis du es tust.
  3. Erzeugung: die im Abschnitt Ausgaben unten aufgeführten Dateien.
  4. Validierung: eine Selbstprüfung von Format, Manifestfeldern, Pack-Definition, Eindeutigkeit der Zwei-Buchstaben-Codes und Integrationsanleitung, dir als Checkliste vorgelegt.

Schnellstart

  1. Das Pack installieren

    Core wird automatisch ergänzt. Maker braucht nur Node.js 20 oder neuer für den Installer.

    Im Terminal deines Projekts
    npx bmad-plus install --packs maker

  2. Maker mit einer Beschreibung rufen

    Je genauer der Zweck, desto weniger Fragen muss er stellen.

    Im Terminal deines Projekts
    Maker, erstelle einen Kundensupport-Agenten.

  3. Entwurfsvorschau prüfen, dann das Paket

    Gib die Vorschautabelle frei oder korrigiere sie. Das Paket erscheint in _bmad-output/ready-to-integrate/.

Beispiele zum Kopieren

Einen Agenten im vollständig geführten Ablauf erstellen (CA)

Nutze es, wenn der Agent mehrere Rollen oder Werkzeuge braucht und du jede Entscheidung steuern willst.

In deinem KI-Assistenten
Maker, erstelle einen Kundensupport-Agenten. Er soll eingehende Tickets sortieren, Antworten in ruhigem Ton entwerfen und Abrechnungsstreitigkeiten an einen Menschen eskalieren. Er braucht Lesezugriff auf die Artikel unseres Help-Centers. Zwei Rollen: Triage und Reply.

Das solltest du erhalten Maker stellt seine fünf Erkundungsfragen in einem einzigen Block (deine Anfrage beantwortet bereits mehrere), zeigt dann die Entwurfsvorschau und wartet auf deine Freigabe. Danach schreibt er das Paket nach _bmad-output/ready-to-integrate/ und zeigt die Validierungs-Checkliste.

Schnell einen kleinen Agenten erstellen (QA)

Nutze es für einen Agenten mit einem einzigen Zweck. Du kannst das Ergebnis danach verfeinern.

In deinem KI-Assistenten
Maker, quick agent: ein Release-Notes-Autor namens Chronicle, der eine Liste zusammengeführter Änderungen in Notizen für Nutzer verwandelt. Icon: eine Schriftrolle.

Das solltest du erhalten Es werden nur zwei Fragen gestellt (Zweck, Name und Icon); alles andere bekommt sinnvolle Vorgaben. Es entstehen dieselben Paketdateien, danach kannst du Änderungen verlangen.

Einen vorhandenen Agenten ändern (EA)

Gib Maker den Ordner des Agenten an und sag, was sich ändern soll. Edit Agent arbeitet an der SKILL.md des Agenten dort, wo sie schon liegt.

In deinem KI-Assistenten
Maker, ändere den Agenten in _bmad-output/ready-to-integrate/agents/agent-chronicle: Füge eine Fähigkeit mit Code BR hinzu, die einen Abschnitt zu inkompatiblen Änderungen entwirft, und präzisiere die Beschreibung in seinem Kopfbereich, damit er nicht bei jeder Anfrage ausgewählt wird, die nur ein Update erwähnt.

Das solltest du erhalten Die SKILL.md des Agenten wird an Ort und Stelle im genannten Ordner geändert, und Maker hält die Regel eindeutiger Fähigkeitscodes ein. Zu seinen Prinzipien gehört, vor dem Abschluss mit dir abzustimmen, also erwarte eine Zusammenfassung der Änderung zur Bestätigung. Das Paket hat keine eigene Trigger-Datei: Wie der Agent ausgewählt wird, ergibt sich aus der Beschreibung in seinem Kopfbereich.

Ein Agentenpaket validieren (VA)

Nutze es, bevor du einen Agenten teilst oder beisteuerst, auch einen, der nicht mit Maker entstanden ist.

In deinem KI-Assistenten
Maker, validiere dieses Agentenpaket: _bmad-output/ready-to-integrate/agents/agent-chronicle. Liste jedes Problem auf und biete an, jedes zu beheben.

Das solltest du erhalten Ein Bericht zu vier Punkten: Formatkonformität der SKILL.md, Vollständigkeit des Manifests, Eindeutigkeit der Fähigkeitscodes und Qualität der Trigger (spezifisch genug oder nicht). Zu jedem Problem gibt es ein Korrekturangebot. Es werden Dateien gelesen; der Agent wird nicht ausgeführt.

Den integrationsfertigen Ordner erzeugen (PA)

Nutze es, wenn der Entwurf feststeht und du die Dateien an einem Ort willst.

In deinem KI-Assistenten
Maker, paketiere den Agenten Chronicle, damit ich den Ordner an einen Mitwirkenden geben kann.

Das solltest du erhalten Der Ordner _bmad-output/ready-to-integrate/ enthält agents/agent-chronicle/SKILL.md, agents/agent-chronicle/bmad-skill-manifest.yaml, pack-definition.yaml und INTEGRATION.md.

Die Agentenvorlage ansehen, bevor du einen schreibst (TP)

Nutze es, um die erwartete Struktur zu lernen oder einen Agenten von Hand zu schreiben.

In deinem KI-Assistenten
Maker, zeig mir die BMAD+-Agentenvorlage.

Das solltest du erhalten Die Vorlage einer Agenten-SKILL.md: Kopfbereich mit name und description, dann die Abschnitte Overview, Identity, Communication Style, Principles, Capabilities (Code, Beschreibung, Skill) und On Activation.

Was es schreibt und wo

Dateien eines erzeugten Pakets
Datei in _bmad-output/ready-to-integrate/Zweck
agents/agent-<name>/SKILL.mdDer Agent: Identität, Stil, Prinzipien, Fähigkeiten, Aktivierung
agents/agent-<name>/bmad-skill-manifest.yamlManifest: Anzeigename, Titel, Icon, Fähigkeiten, Rolle, Pack
pack-definition.yamlEin einfügefertiger Eintrag für die Tabelle packs: in registry.yaml (Reihenfolge, Anzeigename, Icon, Agenten, Personas, Skills, Installationsart)
INTEGRATION.mdSchritte, um den Agenten in die BMAD+-Quellen zu integrieren

Datenflüsse und Voraussetzungen

Maker braucht außer Core und Node.js 20 für den Installer nichts: kein Python, keinen Schlüssel, keinen eigenen Netzwerkdienst. Erstellen und Paketieren schreiben nur nach _bmad-output/ready-to-integrate/; Edit Agent ändert die SKILL.md eines vorhandenen Agenten dort, wo du sie angibst. Die einzigen Daten, die deinen Rechner verlassen, sind die, die dein KI-Werkzeug an sein Modell schickt, wie bei jedem anderen Agenten.

Grenzen und Stolpersteine

Warnung Das Paket zielt auf die BMAD+-Quellen, nicht auf dein installiertes Projekt

Die erzeugte INTEGRATION.md führt dich durch das Hinzufügen des Agenten zum BMAD+-Quell-Repository: den Ordner nach src/bmad-plus/agents/ kopieren, den Pack-Eintrag aus pack-definition.yaml in registry.yaml (die einzige Quelle der Wahrheit) aufnehmen, die Hilfezeile in src/bmad-plus/module-help.csv ergänzen, npm run build und node tools/build/generate-adapters.js --adopt ausführen und mit den Drift-Prüfungen abschließen (npm run build:check, generate-adapters --check --adopt, npm run check:counts). Es dient dazu, Agenten zu BMAD+ selbst beizusteuern; Maker registriert keinen neuen Agenten in einem Projekt, in dem BMAD+ nur installiert ist.

Hinweis Validierung ist das Lesen von Dateien

Makers Prüfungen decken Format, Felder und Eindeutigkeit ab. Sie beweisen nicht, dass sich der neue Agent in der Praxis gut verhält; teste ihn an einer echten Aufgabe, bevor du dich auf ihn verlässt.

Hinweis Herkunft

Maker wurde von Laurent Rochetta geschrieben, dem Autor von BMAD+.

Siehe auch