PRD Writer Skill
Verkapselt das Kern-Denken eines Product Managers in einen ausführbaren Workflow: Zuerst die Richtung validieren, dann in zwei Versionen ausliefern (Konzeptversion → Umsetzungsversion); Diagnose aus drei Perspektiven (User / Business / Technik); aktiv blinde Flecken in Interaktion, Zuständen, Daten und Texten ergänzen.
Dateistruktur
| Datei | Zweck |
|---|---|
SKILL.md (diese Datei) | Zugangskontrolle, Modi, Lieferpfad, Ausführungsreihenfolge |
references/read-first.md | Erst lesen, dann schreiben / Modusbestimmung / Schritt Null Ausnahme |
references/diagnosis-guide.md | Drei-Perspektiven-Diagnose und Produktform |
references/concept-template.md | Vorlage für die erste Konzeptdokument-Version |
references/prd-template.md | Vorlage für die zweite Umsetzungs-PRD (mit MVP-Tor) |
references/diagram-handoff.md | Mermaid vs. diagram-generator |
references/product-type-appendix.md | B2B / ToC / Marketing-Website etc. §7 Ergänzung |
references/review-checklist.md | Prüfpunkte für Modus B |
references/review-output-template.md | Vorlage für den Prüfbericht bei Modus B |
references/example-prd.md | Beispiel für Format und Granularität |
references/self-check.md | Selbstprüfung nach dem Schreiben |
Verwandte Skills: Wenn die Benutzereingabe ein Axure-Export-HTML oder eine Reverse-Engineering einer Online-Seite ist, führe zuerst mit prototype-to-prd eine Bestandsaufnahme durch und folge dann dem Skill-Modus A, um die Konzept-/Umsetzungsversion zu schreiben (Vorlagen aus diesem references/-Verzeichnis verwenden).
Vor dem Schreiben: Lies je nach Modus die entsprechende references/-Datei, dann schreibe.
Liefermodus: Sofern nicht anders angegeben, ist der Standard-Modus dieses Skills „Standard" (siehe README „Liefermodi“; es kann „Schnellmodus“ für eine niedrigere oder „Strengmodus“ für eine höhere Stufe gesagt werden).
0. Liefermodus und Schnellpfad
| Modus | Konzeptversion | MVP-Bestätigung | self-check |
|---|---|---|---|
| Standard (Skill-Standard) | Standardmäßig zwei Dateien; Benutzer sagt „Schnellmodus / Schreib direkt PRD / Überspring Konzeptversion“ → Schnellpfad (eine Datei) | Mit Konzeptversion oder 🔴 im Funktionsbaum §4, keine separate mündliche Bestätigung | Vollständig abhaken |
| Schnell | Übersprungen; Einzeldatei docs/YYYY-MM-DD-<Thema>-PRD.md, mit ## Teil 1 · Konzeptabstimmung kurz zusammengefasst | Standardmäßig alle 🔴 in §4 erweitert | Nur P0-Prozesspunkte |
| Streng | Muss -Konzeptversion.md sein und Benutzer explizit bestätigen | Vor dem Schreiben von §5 N MVPs mündlich bestätigen | Vollständig abhaken |
Schnellpfad / Abwertungs-Trigger (bei Standardmodus als Standard): Schnellmodus, Schreib direkt PRD, Überspring Konzeptversion, Zuerst Umsetzungsentwurf, Einzeldatei PRD.
Ausführungsreihenfolge (Zugangskontrolle)
Benutzernachricht
→ 1. read-first.md (zuerst docs/ und Benutzer-@-Entwurf lesen)
→ 2. Schritt Null (wenn kein Eingabeentwurf; siehe Ausnahmen unten)
→ 3. Modus A / B / C erkennen
→ 4. je nach Modus Vorlage lesen und in docs/ schreiben
→ 5. self-check.md
1. Vor dem Start: Vorhandenes Material lesen
Muss gemäß references/read-first.md ausgeführt werden: docs/ scannen, echte Quellen extrahieren, nur Lücken mit Fragen diagnostizieren, Modus bestimmen.
Schritt-Null-Ausnahme (Einstiegsfragen überspringen, direkt in den Modus):
| Bedingung | Einstieg |
|---|---|
| Benutzer @ / liefert vollständige PRD zur Überprüfung oder Verbesserung | Modus B |
| Benutzer gibt an „nur Modul X hinzufügen / ändern“ und hat Dokumentation bereitgestellt | Modus C |
| Material bereits gelesen und ausreichend, um Richtung und Modus zu bestimmen | Entsprechender Modus |
2. Schritt Null: Ist dieser Skill geeignet
Kein Brainstorming-Werkzeug; geeignet für Benutzer mit bereits grundlegenden Ideen. read-first bereits ausgeführt und genug Informationen → diesen Schritt überspringen.
Wenn kein brauchbarer Eingabeentwurf vorhanden ist, zuerst fragen:
Bevor wir beginnen, kannst du mir kurz deine Kernidee für dieses Produkt/diese Funktion erzählen? Auch nur ein oder zwei Sätze – welches Problem willst du lösen und wie ungefähr willst du es lösen?
| Benutzerantwort | Bewertung | Behandlung |
|---|---|---|
| Kann sagen „wer hat welches Problem, mit welcher Methode lösen“ | ✅ | Gehe zu Modus A, Schritt 1 |
| Vage aber mit Richtung, z. B. „eine Ausgaben-App machen“ | ⚠️ | Nachfragen, um die Kernlogik zu klären |
| Völlig ohne Richtung, z. B. „Hilf mir, eine App-Idee zu finden“ | ❌ | Sanft führen, zuerst das Problem klären, noch keine PRD schreiben |
3. Modus erkennen
| Benutzersituation | Modus |
|---|---|
| Hat eine Idee, aber noch kein Dokument | A: Von Grund auf, in zwei Versionen generieren |
| Hat bereits ein Dokument, möchte es überprüfen/verbessern | B: Bewerten + Verbessern |
| Hat bereits ein Dokument, möchte es erweitern oder detaillieren | C: Inkrementelle Fusion |
4. Liefergegenstand: Format und Pfad
| Punkt | Regel |
|---|---|
| Format | Markdown; Datei ist maßgeblich, Chat kann Zusammenfassung sein |
| Pfad | Workspace docs/ (erstellen falls nicht vorhanden) |
| Konzeptversion | docs/YYYY-MM-DD-<Thema>-Konzeptversion.md |
| Umsetzungsversion | docs/YYYY-MM-DD-<Thema>-PRD.md; am Anfang eine Zeile mit Link zum Konzeptversion-Pfad |
| Prüfbericht | docs/YYYY-MM-DD-<Thema>-PRD-Prüfung.md (Modus B standardmäßig gespeichert) |
| Aufteilungsstrategie | Standardmäßig separate Dateien; bei Benutzerwunsch nach Einzeldatei: ## Teil 1 · Konzeptabstimmung (bestätigt) / ## Teil 2 · Umsetzungsanforderungen |
Word-Export: Dieses Open-Source-Skill-Paket enthält keine Exportfähigkeit. Das Exportieren der Markdown-PRD als Word (
.docx) ist nur für VibePM-Zahlungsschüler im vollständigen Ressourcenpaket verfügbar; bei eigenständiger Installation ist Markdown die verbindliche Ausgabe.
Metadaten am Dateianfang, Kapitelstruktur siehe concept-template.md, prd-template.md. Format siehe example-prd.md.
5. Modus A: Schrittweise Führung von Grund auf
Schritt 1: Drei-Perspektiven-Diagnose
Gemäß references/diagnosis-guide.md: User / Business / Entwicklung + Produktform; pro Runde 1–2 Fragen.
- Schnellmodus: Bei klarer Richtung zu einer Runde zusammenfassen, nicht jede Perspektive einzeln nachfragen
- Standard/Streng: Nach Abschluss mündliche Zusammenfassung; Streng erfordert Benutzerbestätigung vor dem Schreiben der Konzeptversion
Schritt 2: Konzeptversion
- Schnellpfad / Schnellmodus: Diesen Schritt überspringen, zu Schritt 3 gehen (bei Einzeldatei am Anfang der PRD eine 8–12-zeilige Richtungszusammenfassung schreiben)
- Standard / Streng: Gemäß
references/concept-template.mdin-Konzeptversion.mdschreiben Einziges Ziel: Richtung abstimmen. Streng: Vor expliziter Benutzerbestätigung keinen §5 der Umsetzung schreiben. „Passt schon“ ist bei Streng keine Bestätigung; Standard: Benutzer sagt „okay/weiter“ und dann kann zur Umsetzungsversion übergegangen werden.
Schritt 3: Umsetzungsversion
Gemäß references/prd-template.md in -PRD.md schreiben.
- MVP-Tor: Standardmäßig nur §5 mit 🔴 erweitern; Streng: Vor dem Schreiben mündlich N MVPs bestätigen; Standard/Schnell: Funktionsbaum §4 mit 🔴 ist maßgeblich, keine extra Frage
- Diagramme: Gemäß
references/diagram-handoff.md(einfaches Mermaid inline, komplexes mit diagram-generator) - §7: Gemäß
references/product-type-appendix.mdauslösen und ergänzen
6. Modus B: Bewerten + Verbessern
Read→review-checklist.md, Punkt für Punkt ✅ / ❌ / ⚠️- Gemäß
review-output-template.mdin-PRD-Prüfung.mdschreiben (nur speichern, wenn Benutzer explizit nur Konversationsergebnis möchte) - Benutzer fragen: Direkt ergänzen vs. selbst ändern und dann erneut bewerten
- Ergänzung nach Modus-C-Regeln, mit
【Dieses Update】markieren
7. Modus C: Inkrementelle Fusion
Prinzip: Fusion ohne Überschreiben, Update ohne Neuschreiben.
- Vorhandenes Dokument einlesen (Pfad oder Einfügen)
- Hinzuzufügenden/zu ändernden Bereich klären
- Betroffene Kapitel identifizieren (üblich: Funktionsliste, User Flow §3, §5, Texte)
- In die entsprechenden Stellen integrieren; bei Konflikten dem Benutzer zur Entscheidung vorlegen
【Dieses Update】bei allen Änderungen markieren- Konsistenz von User Flow, §5, Listen prüfen →
self-check.md
8. Allgemeine Prinzipien
- Phasenweise: Streng – Konzeptversion nicht bestätigt → keine Details zu §5 der Umsetzung schreiben; Standard-Schnellpfad/Schnellmodus können zusammengefasst werden
- Drei Perspektiven: Schnell – kann komprimiert werden; Streng – alle drei Perspektiven benötigen grundlegende Antworten
- Blinde Flecken füllen: Interaktion, Zustände, Daten, duale Zielgruppentexte – aktiv ergänzen, nicht abwarten, bis der Benutzer fragt
- Duale Zielgruppen: Entwickler/KI-Spezifikation vs. Endbenutzertexte – getrennt schreiben
- Fusion ohne Überschreiben: Modus C – Originaltext nicht verlieren
[Noch zu ergänzen]nicht erfinden: Auswirkungen klar kennzeichnen- Diagramme und Tabellen: User Flow Mermaid, Zustandstabelle, Funktionsbaum, ASCII-Wireframes (siehe diagram-handoff)
- Erst lesen, dann schreiben, MVP zuerst: Siehe read-first, prd-template MVP-Tor
- Word-Export: Wenn Benutzer Word-Export fordert, erklären, dass diese Funktion nur für VibePM-Zahlungsschüler im vollständigen Ressourcenpaket verfügbar ist; dieses Open-Source-Paket ruft
export-wordnicht auf, Markdown ist die verbindliche Ausgabe.
Nach dem Schreiben unbedingt references/self-check.md durchgehen (Schnell-Modus nur P0-Punkte von „Prozess und Zugangskontrolle“ und „Umsetzungsversion“ abhaken).