atmostfair/renpy-story-extraction-skill

Was macht renpy-story-extraction-skill?

Codex-Fähigkeit für Ren'Py Visual Novel Story-Referenz-Workflows: NotebookLM-Quellen, private Wissensdatenbanken, RAG, narrative Analyse, Lokalisierungsprüfung und Schreibunterstützung.

Funktionsweise

Die Fähigkeit analysiert Ren'Py-Skriptdateien (.rpy) und extrahiert:

• Charakterdialoge mit Kontext (Sprecher, Ort, Szene)
• Erzählerpassagen (Beschreibungen, Gedanken, Erzählerstimmen)
• Verzweigungslogik und Bedingungen (Menüs, if-Blöcke, jump-Anweisungen)
• Spielmetadaten (Titel, Kapitel, Autoren, Version)
• Lokalisierungsdaten (.rpy-Dateien mit Übersetzungen)

Verwendung in Codex

1. Extrahieren von Story-Referenzen:

   • Öffne eine Ren'Py-Projektordnerstruktur in VS Code.
   • Führe den Befehl Story Extraction: Extract Story References aus (via Befehlspalette oder Shortcut).
   • Wähle die .rpy-Dateien oder den gesamten Projektordner aus.

2. Ausgabeoptionen:

   • Markdown-Datei: Erzeugt eine einzelne .md-Datei mit allen strukturierten Story-Blöcken.
   • CSV-Datei: Erzeugt eine Tabelle mit Dialog, Sprecher, Ort und Metadaten.
   • NotebookLM-kompatibel: Erzeugt eine formatierte .txt-Datei, die direkt in NotebookLM importiert werden kann.

3. Workflow-Beispiele:

   • NotebookLM-Quellen: Verwende die .txt-Ausgabe, um Notizen, Zusammenfassungen und Fragen zu generieren.
   • Private Wissensdatenbanken: Lade die .md- oder .csv-Ausgabe in eine Vektordatenbank für RAG.
   • Narrative Analyse: Untersuche Dialogmuster, Charakterentwicklung und Handlungsverläufe.
   • Lokalisierungsprüfung: Vergleiche originale und übersetzte .rpy-Dateien mit dem Locale Compare-Befehl.
   • Schreibreferenz: Nutze die extrahierten Dialoge als Stilvorlage für eigene Szenen.

Voraussetzungen

• Codex (GitHub Copilot Chat in VS Code)
• Ren'Py SDK (für .rpy-Dateien)
• Python 3.8+ (für einige Skripte)

Installation

1. Klone das Repository in dein Codex-Skills-Verzeichnis:

   git clone https://github.com/atmostfair/renpy-story-extraction-skill.git
   

2. Öffne VS Code und aktualisiere die Codex-Konfiguration (settings.json):

   {
     "codex.skills": [
       "path/to/renpy-story-extraction-skill"
     ]
   }
   

3. Starte VS Code neu (oder lade das Fenster neu).

Befehle

Befehl	Beschreibung
Story Extraction: Extract Story References	Extrahiert Story-Daten aus .rpy-Dateien
Story Extraction: Locale Compare	Vergleicht originale und übersetzte .rpy-Dateien
Story Extraction: Generate NotebookLM Source	Erzeugt eine NotebookLM-kompatible .txt-Datei

Lizenz

MIT