Dev-Studio-Workflows auflisten und für einen davon ein schreibgeschütztes Kontextpaket vorbereiten, damit dein Assistent ihn mit den exakt mitgelieferten Anweisungen deines Projekts ausführt.
Dev Studio ist das Pack mit sechs Personas (Miriam, Huldah, Yosef, Rachel, Bezalel, Oholiab) und 38 Workflows wie product-brief, validate-prd oder investigate. Ein Workflow ist eine Markdown-Prozedur, der dein Assistent folgt. bmad-plus studio führt nichts aus: list zeigt den Katalog, und prepare bündelt alles, was der Assistent für einen Workflow braucht (Konfiguration, mitgelieferte Anweisungen, die von dir genannten Dateien), mit einem Hash pro Datei. Gedacht für einen reproduzierbaren Start oder ein Skript, das das Bündel an einen Assistenten übergibt.
Liest .agents/skills/pack-dev-studio/ (den Katalog shared/catalog.json, die Persona-Datei, die Workflow-Datei und die Ressourcen, auf die sie verweist), _bmad/config.yaml, deine --input-Dateien und den vorherigen Bericht, falls vorhanden.
Schreibt nichts. Weder den Bericht noch einen Cache noch die Konfiguration. Der vorgeschlagene Berichtspfad ist <output_folder>/dev-studio/<workflow-id>.md (standardmäßig _bmad-output/dev-studio/<workflow-id>.md); dein Assistent schreibt ihn später.
Öffnet keine Netzwerkverbindung und startet keinen Prozess. Das Bündel ist auf 2 MiB begrenzt.
Braucht das Dev-Studio-Pack: npx bmad-plus install --packs core,dev-studio.
Jeder Workflow erklärt, was er braucht. Fehlt es, gibt prepare das Bündel trotzdem aus, meldet aber needs-input und endet mit Code 2, sodass ein Skript vor dem Aufruf des Assistenten nachfragen kann.
Eingabearten im Katalog
Art
Verlangt
Beispiele
request
Ein --request-Text oder mindestens eine --input-Datei.
product-brief, create-prd, create-architecture
project
Ein --request-Text oder mindestens eine --input-Datei.
list war erfolgreich, oder der Status von prepare ist ready.
2
Der Status von prepare ist needs-input: Dem Workflow fehlt seine Anfrage oder seine Eingabedatei.
1
Fehler: Pack nicht installiert, unbekannter Workflow, ungültige Eingabe, unlesbare Konfiguration. Mit --json wird der Fehler als {"schemaVersion":1,"status":"error","error":"..."} ausgegeben.
$ npx bmad-plus studio listproduct-brief (analyst-agent; input: request)prfaq (analyst-agent; input: request)document-project (tech-writer-agent; input: project)market-research (analyst-agent; input: request)domain-research (analyst-agent; input: request)technical-research (analyst-agent; input: request)create-prd (pm-agent; input: request)prd (pm-agent; input: request)edit-prd (pm-agent; input: artifact)validate-prd (pm-agent; input: artifact)...investigate (dev-agent; input: project)# Die echte Liste hat 38 Workflows; die mit „...“ markierten Zeilen sind hier ausgelassen.
npx bmad-plus studio list
Ausgabe eines echten Laufs. Quelle: Mit dem Paket 0.23.0 (Packs Core und Dev Studio) in einem Wegwerfprojekt nachgespielt; Zeilen ausgelassen, wo markiert
Einen Workflow vorbereiten, dem die Eingabe fehlt
$ npx bmad-plus studio prepare validate-prdvalidate-prd: needs-input — prepared for the host, not executed.Project: /work/appRequest: (none supplied)Resolved configuration:{ "user_name": "Developer", "communication_language": "English", "document_output_language": "English", "output_folder": "_bmad-output", "project_name": "app"}Defaulted fields: (none)Proposed report: _bmad-output/dev-studio/validate-prd.mdSupply a project artifact with --input RELATIVE_FILE.--- shared/execution.md (b8152ec5057fc79749aa7b0823fa35c241c6a0c3f13d12716fa3aae11bcbf354) ---...# Exit-Code 2. Die angezeigten Werte hängen von deiner _bmad/config.yaml ab; die langen Anweisungstexte danach sind ausgelassen („...“).
npx bmad-plus studio prepare validate-prd
Ausgabe eines echten Laufs. Quelle: Mit dem Paket 0.23.0 (Packs Core und Dev Studio) in einem Wegwerfprojekt nachgespielt; der Projektpfad ist durch /work/app ersetzt und die langen Anweisungstexte sind ausgelassen
Die Text-Zusammenfassung gibt der Reihe nach aus: den Workflow und seinen Status, den Projektordner, die Anfrage, die aufgelöste Konfiguration, welche Konfigurationsfelder auf einen Standardwert zurückgefallen sind, den vorgeschlagenen Berichtspfad, was noch fehlt, dann jede Anweisungsdatei und jede Eingabedatei mit ihrem SHA-256. Existiert am vorgeschlagenen Pfad schon ein Bericht, folgt sein Inhalt unter „Continue existing report“, damit der Assistent weitermacht statt neu anzufangen. Mit --json bilden dieselben Daten ein einziges Objekt mit schemaVersion, status (ready oder needs-input), execution: "host-managed", executed: false, catalogSha256, instructions, inputs und missingInputs.
Hinweis· Vorbereitet heißt nicht ausgeführt
Das Bündel belegt, dass die Anweisungen geliefert wurden und welche Bytes sie hatten. Es belegt nicht, dass der Assistent ihnen gefolgt ist, und nichts darin schreibt den Bericht oder führt Tests aus. Unabhängige Agenten, Browsen und Befehlsausführung hängen von deinem Assistenten ab.
Dev Studio ist installiert. Miriam soll von einem präzisen Umfang ausgehen, und die exakten Anweisungen sollen per Hash festgehalten werden.
In deinem KI-Assistenten
Miriam, nutze product-brief, um das kleinste nützliche Ticket-Triage-Werkzeug für unser Support-Team zu definieren. Wenn die CLI verfügbar ist, führe zuerst `npx bmad-plus studio prepare product-brief --request "Das kleinste nützliche Triage-Werkzeug definieren" --json` aus und arbeite mit diesem Bündel.
Das solltest du erhalten Der Befehl gibt ein Bündel mit Status ready, executed: false, dem vorgeschlagenen Berichtspfad _bmad-output/dev-studio/product-brief.md und den mitgelieferten Anweisungen samt Hashes aus. Miriam folgt dann dem Verfahren product-brief und schreibt den Bericht an diesen Pfad; der Befehl selbst hat nichts geschrieben.
validate-prd ist ein Workflow der Art artifact: Er braucht die zu validierende Datei.
In deinem KI-Assistenten
Yosef, validate-prd für docs/prd.md. Bereite den Kontext mit `npx bmad-plus studio prepare validate-prd --input docs/prd.md --json` vor und melde einen Befund nur, wenn du auf den Text zeigen kannst, der ihn stützt.
Das solltest du erhalten Ohne --input würde der Befehl needs-input ausgeben und mit 2 enden. Mit der Option ist der Status ready, die Datei steht mit ihrem SHA-256 unter inputs, und der vorgeschlagene Bericht ist _bmad-output/dev-studio/validate-prd.md. Yosef validiert genau diesen Dateiinhalt.