Communitygithub.com

chandrapratamalab/phantom-skill

Erstellen Sie ein umfassendes Produkt- und technisches Anforderungsdokument (PRD-Projekt) mit visuellen Mermaid-Diagrammen durch einen interaktiven zweistufigen Workflow. Verwenden Sie dies, wenn der Benutzer nach der Erstellung eines PRD, der Planung eines Software-/Web-/Mobil-/KI-/Spielprojekts, dem Schreiben von Spezifikationen oder dem Entwerfen einer Systemarchitektur fragt.

Was ist phantom-skill?

Dieser Skill, `Universal PRD Writer` genannt, verwandelt jede Projektidee in ein vollständiges, entwicklerbereites Produkt- und technisches Anforderungsdokument (PRD.md). Er ist für KI-Agenten wie Claude Code, Cursor und Codex konzipiert und folgt einem interaktiven zweistufigen Workflow. Im ersten Schritt analysiert der Skill die Eingabeaufforderung des Benutzers und stellt dynamisch 4–5 domänenspezifische Fragen, um das Verständnis zu verfeinern und unnötige Generierungen zu vermeiden. Im zweiten Schritt erstellt er ein strukturiertes 7-teiliges PRD-Dokument mit Abschnitten für Übersicht, Anforderungen, Kernfunktionen, Benutzerablauf (mit Mermaid-Flussdiagramm), Architektur (mit Mermaid-Diagramm), Datenbankschema (angepasst an den Projekttyp) und Tech-Stack. Der Skill stellt sicher, dass alle Mermaid-Diagramme syntaktisch korrekt sind, und liefert umsetzbare Spezifikationen ohne überflüssige Informationen, die für die direkte Implementierung durch Entwickler oder KI-Codierungsagenten bereit sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chandrapratamalab/phantom-skill/tree/HEAD/skills/prd-writer

In Ihrer bevorzugten KI fragen

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

Dokumentation

Universal-PRD-Autor

Verwandeln Sie jede Projektidee in ein vollständiges, entwicklerbereites Produkt- und technisches Anforderungsdokument (PRD.md).

Workflow

Schritt 1: Prompt analysieren und dynamische klärende Fragen stellen

Generieren Sie das vollständige PRD NICHT beim ersten Mal, es sei denn, der Benutzer sagt explizit „buat langsung“ / „Fragen überspringen“ oder hat bereits vollständige Details angegeben.

  1. Projekttyp erkennen: Identifizieren Sie aus der Eingabeaufforderung des Benutzers, was er erstellt (z. B. 3D-/Bewegungs-Website, SaaS/Web-App, Mobile App, KI-Agent/Bot, Spiel, CLI/Plugin oder Unternehmenssystem).
  2. 4 bis 5 hochrelevante Fragen stellen: Formulieren Sie Fragen, die streng auf die Domäne dieses spezifischen Projekts zugeschnitten sind:
    • Fragen Sie nach dem Kernziel/Zielbenutzer und der erwarteten endgültigen Aktion.
    • Fragen Sie nach domänenspezifischen Mechanismen (z. B. 3D-/Scroll-Interaktionen für eine Bewegungsseite; Benutzerrollen und Zahlungsablauf für SaaS; Trigger-/API-Ablauf für einen Bot; Spielschleife für ein Spiel).
    • Fragen Sie nach MVP-Umfangsgrenzen und technischen/Bibliothekspräferenzen oder Geräteeinschränkungen.
  3. Kurze Beispiele geben: Fügen Sie nach jeder Frage kurze Optionen in Klammern ein, damit der Benutzer schnell antworten kann. Erinnern Sie ihn: „Beantworten Sie die Punkte, die Sie bereits im Kopf haben, oder geben Sie 'buat langsung' ein, damit ich automatisch die beste Option auswähle.“

Schritt 2: Das 7-teilige PRD-Projekt generieren

Sobald der Benutzer antwortet (oder darum bittet, sofort fortzufahren), speichern Sie die Ausgabe in PRD.md (falls in einem Code-Workspace) und präsentieren Sie das Dokument mit der folgenden exakten 7-teiligen Struktur, wobei der technische Inhalt dynamisch an den Projekttyp angepasst wird:

# PRD-Projekt: [Projektname]
## Anforderungsdokument

### 1. Übersicht
- **Produktzusammenfassung:** Konzept, gelöstes Kernproblem und einzigartiges Wertversprechen.
- **Zielgruppe und Personas:** Benutzerrollen, Ziele und Schwachstellen.
- **Ziele und Erfolgsmetriken:** Messbare KPIs, die auf das Projekt zugeschnitten sind (z. B. Konversionsrate, FPS/Ladegeschwindigkeit, Bindung oder Aufgaben-Genauigkeit).

### 2. Anforderungen
- **Funktionale Anforderungen:** Kernfähigkeiten, logisch nach Rolle, Modul oder Bildschirmabschnitt gruppiert.
- **Nicht-funktionale Anforderungen:** Leistungsbenchmarks, Reaktionsfähigkeit, Sicherheit, Kompatibilität und Ressourcengrenzen.
- **Nicht im Umfang (Phase 1):** Funktionen, die bewusst aus der Erstversion ausgeschlossen wurden.

### 3. Kernfunktionen
Für jede Funktion/jedes Modul spezifizieren:
- **Priorität:** P0 (Muss), P1 (Sollte), P2 (Nice-to-Have).
- **User Story:** Als [Rolle] möchte ich [Aktion], damit [Nutzen].
- **Akzeptanzkriterien:** Konkrete, testbare Bestehens-/Nichtbestehensbedingungen.
- **Randfälle und Fallbacks:** Behandlung von Fehlern, leeren Zuständen, schwachen Geräten/nicht unterstützten Browsern oder fehlgeschlagenen Anfragen.

### 4. Benutzerablauf
- **Schritt-für-Schritt-Reise:** Chronologischer Benutzer- oder Systeminteraktionspfad von Anfang bis Ende.
- **Visuelles Flussdiagramm:** Ein sauberes `mermaid`-Diagramm rendern (`flowchart TD` oder `sequenceDiagram`).

### 5. Architektur
- **System- und Ordnerstruktur:** Hochrangige Komponenteninteraktion und empfohlenes Verzeichnislayout.
- **Architekturdiagramm:** Ein `mermaid`-Diagramm rendern, das zeigt, wie UI, Logik, APIs, Render-Schleifen oder externe Dienste verbunden sind.
- **Kernmodule / Endpunkte:** Tabelle mit Schlüsselrouten, Controllern oder Ereignisbehandlern.

### 6. Datenbankschema (Anpassbar an Projekttyp)
- **Wenn Backend / Dauerhafte App:** Ein Mermaid `erDiagram` und Tabellenschemata (Felder, Typen, PK/FK-Einschränkungen, Beziehungen) bereitstellen.
- **Wenn reines Frontend / Statisch / 3D / CLI / Tool:** Das lokale Zustandsschema, die Konfigurations-JSON-Struktur, das Asset-Manifest oder das Formular-/Ereignis-Payload-Schema anstelle von SQL-Tabellen definieren.

### 7. Tech-Stack
Empfehlen Sie die optimalen Tools mit kurzen Begründungen, die auf die Einschränkungen des Benutzers zugeschnitten sind (Frontend/UI, Logik/Backend, Daten/Assets, Bereitstellung).

Diagramm- und Qualitätsregeln

  • Nur gültiges Mermaid: Umfassen Sie Knotenbeschriftungen mit Leerzeichen, Klammern oder Symbolen immer in doppelten Anführungszeichen (z. B. A["Hero Section (3D View)"] --> B["Scroll Trigger"]), damit Diagramme ohne Syntaxfehler sauber gerendert werden.
  • Kein Füllmaterial: Halten Sie Spezifikationen konkret, umsetzbar und bereit für die direkte Implementierung durch Entwickler oder KI-Codierungsagenten.

Verwandte Skills