CommunitySchreiben & Editierengithub.com

vibepm666/prd-writer

Hilft dir, von null auf hochwertige PRDs zu schreiben, bestehende Anforderungsdokumente zu bewerten, zu verbessern oder inkrementell zu aktualisieren. Der Skill diagnostiziert aus drei Perspektiven (User / Business / Technik), erstellt eine **Konzeptversion** und eine **Umsetzungsversion** im Workspace und ergänzt systematisch Interaktionszustände, Datenspezifikationen, Texte und Wireframes – direkt einsatzbereit für Entwicklung oder KI-Codegenerierung.

Was ist prd-writer?

Dieser Skill für KI-Agenten (z. B. Claude Code, Cursor, Codex) verkapselt das Kern-Denken eines Product Managers in einen ausführbaren Workflow. Er validiert zuerst die Richtung, liefert dann eine zweistufige Ausgabe (Konzeptversion → Umsetzungsversion) und diagnostiziert aus drei Perspektiven (User, Business, Technik). Er füllt automatisch blinde Flecken in Interaktion, Zuständen, Daten und Texten. Der Skill unterstützt drei Modi: Standard (Standard), Schnell (Quick) und Streng (Strict), sowie drei Muster: A (von Grund auf neu), B (Bewertung + Verbesserung) und C (inkrementelle Fusion). Er erzeugt strukturierte Markdown-Dokumente im `docs/`-Verzeichnis und stellt sicher, dass die Ergebnisse direkt von Entwicklern oder KI zur Codegenerierung genutzt werden können. Er enthält eine umfangreiche Referenzbibliothek mit Vorlagen, Checklisten und Beispielen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add vibepm666/prd-writer

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

DateiZweck
SKILL.md (diese Datei)Zugangskontrolle, Modi, Lieferpfad, Ausführungsreihenfolge
references/read-first.mdErst lesen, dann schreiben / Modusbestimmung / Schritt Null Ausnahme
references/diagnosis-guide.mdDrei-Perspektiven-Diagnose und Produktform
references/concept-template.mdVorlage für die erste Konzeptdokument-Version
references/prd-template.mdVorlage für die zweite Umsetzungs-PRD (mit MVP-Tor)
references/diagram-handoff.mdMermaid vs. diagram-generator
references/product-type-appendix.mdB2B / ToC / Marketing-Website etc. §7 Ergänzung
references/review-checklist.mdPrüfpunkte für Modus B
references/review-output-template.mdVorlage für den Prüfbericht bei Modus B
references/example-prd.mdBeispiel für Format und Granularität
references/self-check.mdSelbstprü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

ModusKonzeptversionMVP-Bestätigungself-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ätigungVollständig abhaken
SchnellÜbersprungen; Einzeldatei docs/YYYY-MM-DD-<Thema>-PRD.md, mit ## Teil 1 · Konzeptabstimmung kurz zusammengefasstStandardmäßig alle 🔴 in §4 erweitertNur P0-Prozesspunkte
StrengMuss -Konzeptversion.md sein und Benutzer explizit bestätigenVor dem Schreiben von §5 N MVPs mündlich bestätigenVollstä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):

BedingungEinstieg
Benutzer @ / liefert vollständige PRD zur Überprüfung oder VerbesserungModus B
Benutzer gibt an „nur Modul X hinzufügen / ändern“ und hat Dokumentation bereitgestelltModus C
Material bereits gelesen und ausreichend, um Richtung und Modus zu bestimmenEntsprechender 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?

BenutzerantwortBewertungBehandlung
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

BenutzersituationModus
Hat eine Idee, aber noch kein DokumentA: Von Grund auf, in zwei Versionen generieren
Hat bereits ein Dokument, möchte es überprüfen/verbessernB: Bewerten + Verbessern
Hat bereits ein Dokument, möchte es erweitern oder detaillierenC: Inkrementelle Fusion

4. Liefergegenstand: Format und Pfad

PunktRegel
FormatMarkdown; Datei ist maßgeblich, Chat kann Zusammenfassung sein
PfadWorkspace docs/ (erstellen falls nicht vorhanden)
Konzeptversiondocs/YYYY-MM-DD-<Thema>-Konzeptversion.md
Umsetzungsversiondocs/YYYY-MM-DD-<Thema>-PRD.md; am Anfang eine Zeile mit Link zum Konzeptversion-Pfad
Prüfberichtdocs/YYYY-MM-DD-<Thema>-PRD-Prüfung.md (Modus B standardmäßig gespeichert)
AufteilungsstrategieStandardmäß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.md in -Konzeptversion.md schreiben 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.md auslösen und ergänzen

6. Modus B: Bewerten + Verbessern

  1. Read → review-checklist.md, Punkt für Punkt ✅ / ❌ / ⚠️
  2. Gemäß review-output-template.md in -PRD-Prüfung.md schreiben (nur speichern, wenn Benutzer explizit nur Konversationsergebnis möchte)
  3. Benutzer fragen: Direkt ergänzen vs. selbst ändern und dann erneut bewerten
  4. Ergänzung nach Modus-C-Regeln, mit 【Dieses Update】 markieren

7. Modus C: Inkrementelle Fusion

Prinzip: Fusion ohne Überschreiben, Update ohne Neuschreiben.

  1. Vorhandenes Dokument einlesen (Pfad oder Einfügen)
  2. Hinzuzufügenden/zu ändernden Bereich klären
  3. Betroffene Kapitel identifizieren (üblich: Funktionsliste, User Flow §3, §5, Texte)
  4. In die entsprechenden Stellen integrieren; bei Konflikten dem Benutzer zur Entscheidung vorlegen
  5. 【Dieses Update】 bei allen Änderungen markieren
  6. Konsistenz von User Flow, §5, Listen prüfen → self-check.md

8. Allgemeine Prinzipien

  1. Phasenweise: Streng – Konzeptversion nicht bestätigt → keine Details zu §5 der Umsetzung schreiben; Standard-Schnellpfad/Schnellmodus können zusammengefasst werden
  2. Drei Perspektiven: Schnell – kann komprimiert werden; Streng – alle drei Perspektiven benötigen grundlegende Antworten
  3. Blinde Flecken füllen: Interaktion, Zustände, Daten, duale Zielgruppentexte – aktiv ergänzen, nicht abwarten, bis der Benutzer fragt
  4. Duale Zielgruppen: Entwickler/KI-Spezifikation vs. Endbenutzertexte – getrennt schreiben
  5. Fusion ohne Überschreiben: Modus C – Originaltext nicht verlieren
  6. [Noch zu ergänzen] nicht erfinden: Auswirkungen klar kennzeichnen
  7. Diagramme und Tabellen: User Flow Mermaid, Zustandstabelle, Funktionsbaum, ASCII-Wireframes (siehe diagram-handoff)
  8. Erst lesen, dann schreiben, MVP zuerst: Siehe read-first, prd-template MVP-Tor
  9. 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-word nicht 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).

Verwandte Skills