Communitygithub.com

phone-screen-horror

Erstelle vertikale Handy-Bildschirm-Narrativkurzfilme im Stil des 'Analogen Horrors', bei denen das Publikum die Handlung über die Interaktion mit dem Handy-Bildschirm der Hauptfigur verfolgt.

Was ist phone-screen-horror?

Dieses Skill (phone-screen-horror) ist spezialisiert auf die Produktion von vertikalen Kurzfilmen, die die gesamte Handlung ausschließlich über den Handy-Bildschirm einer Figur erzählen – ein Stil, der oft als 'Analog Horror' oder 'Handy-Bildschirm-Narrativ' bezeichnet wird. Die Oberflächen werden entweder mit einem HTML-UI-Kit gerendert oder mit Bildgenerierungsmodellen erstellt, um interaktive Elemente wie Klick-Feedback, Pinyin-Eingabe, Scrollen, App-Animationen, Benachrichtigungen und sich ändernde Sperrbildschirm-Daten zu simulieren. Das Skill ist für Entwickler und kreative Anwender konzipiert, die keine tiefgehenden Programmierkenntnisse benötigen – der Skill-Agent übernimmt die gesamte technische Umsetzung: von der Bilderstellung über die Animation bis hin zur Audioproduktion (Umgebungsgeräusche, Tastatur, UI, Sprachausgabe, Musik, Sirenen). Es wird ein MP4-Video exportiert und optional eine Vorlage für Jianying (剪映专业版) erstellt. Das Skill ist besonders nützlich für die schnelle Produktion von Social-Media-Content, interaktiven Geschichten oder Horror-Kurzfilmen, bei denen die Handlung durch alltägliche Handy-Interaktionen wie Chatnachrichten, Benachrichtigungen oder Sperrbildschirmänderungen vorangetrieben wird. Es unterstützt Windows und macOS, wobei die Jianying-Integration nur unter Windows getestet wurde. Das Skill enthält viele wertvolle Lektionen aus der Praxis, z. B. die Bedeutung eines langsamen Tempos (der erste Entwurf war 94 Sekunden zu schnell; die finale Version dauerte 6 Minuten und 45 Sekunden), die Sichtbarkeit der Tastatur beim Tippen, und dass jeder Klick eine sichtbare Rückmeldung erfordert.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/doublerabbit-star/phone-screen-horror/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Handy-Bildschirm-Narrativkurzfilm (Analog Horror) Erstellung

Werkzeuge befinden sich in scripts/ und ui_kit/, detaillierte Anleitungen in references/. Beispielwerk „Bewerbung beendet" (6 Min 45 Sek, 141 Einstellungen, 11 Szenen) mit Szenenskript in examples/yingpin/. Lies zuerst diese Datei, dann je nach Bedarf die Referenzen.

Anleitung für Anfänger

Wenn der Benutzer sagt „Ich kann das nicht", „Erstes Mal" oder nur einen Satz als Geschichte liefert, gehe wie folgt vor:

  1. Prüfe zuerst die tatsächliche Machbarkeit: Überprüfe lokale Dateilesefähigkeit, Befehlsausführung, sowie Python, benötigte Pakete, ffmpeg/ffprobe, Browser und chinesische Schriftarten. Pfade und Systeme können vom Tool selbst überprüft werden – frage nicht erneut nach. Wenn die Tools nicht ausgeführt werden können, teile klar mit, dass du nur die Geschichte strukturieren kannst, und behaupte nicht, bereits ein Video generiert zu haben.
  2. Senke die Einstiegshürde für die Geschichte: Ein einziger Gedanke reicht aus, um zu beginnen – fordere nicht zuerst eine lange Tabelle. Wenn es an Ideen mangelt, gib drei kurze Vorschläge; wenn bereits eine Idee existiert, arbeite sie zu einem kurzen Handlungsabschnitt und den wichtigsten Bildschirmtexten aus. Frage nur nach entscheidenden Details, die die Richtung der Geschichte ändern; für Details verwende sinnvolle Standardwerte und erkläre diese.
  3. Erkläre die nächsten Schritte klar: Sage z. B. „Ich werde diese Geschichte zuerst in eine abspielbare Vorschau mit Ton umsetzen. Du sagst mir dann, wo es zu schnell oder nicht spannend genug ist.“ Wirf dem Benutzer keine Skriptnamen, Parameter und Verzeichnisstrukturen zu, und lass ihn nicht zwischen technischen Lösungen wählen.
  4. Übe zuerst mit geringer Komplexität: Wenn der Benutzer keinen Umfang angibt, schlage etwa eine Minute mit wenigen Szenen vor. Erzähle eine einfache Geschichte mit Chats, Benachrichtigungen und Sperrbildschirm, und liefere standardmäßig nur eine MP4-Datei. Passe die Lesegeschwindigkeit an die tatsächliche Zeit an, beschleunige nicht, um die Laufzeit zu erreichen. Wenn der Benutzer bereits eine vollständige Geschichte hat, behalte deren Umfang bei – erzwinge keine Kürzung auf eine Übung.
  5. Minimiere Materialabhängigkeiten: Bevorzuge HTML-Oberflächen, Text-Avatare und einfache Grafiken. Liste nur dann konkrete Materialanforderungen auf, wenn die Geschichte Fotos benötigt. Wenn Bildwerkzeuge in der Umgebung verfügbar sind, hilf bei der Erstellung. Wenn sie nicht generiert werden können, gib Prompt-Vorschläge und bitte den Benutzer um Bereitstellung. Fordere Anfänger nicht auf, von Anfang an viele Screenshots vorzubereiten.
  6. Setze die Produktion tatsächlich um: Erstelle nach Klärung der Geschichte und Verfügbarkeit der notwendigen Umgebung eine Audiovorschau, die den gesamten Inhalt von Anfang bis Ende abdeckt, und sammle dann Feedback. Der Benutzer muss nur mit Gefühlsbeschreibungen wie „zu schnell zum Lesen", „zu laut" oder „Ende etwas langsamer" Änderungen vorschlagen – fordere keine Einstellungsnummern.
  7. Gib bei Benutzereingriffen konkrete Hilfe: Python-Pakete, die innerhalb der Berechtigungen installiert werden können, erledige du selbst. Wenn Systemsoftware oder Berechtigungen erforderlich sind und der Benutzer eingreifen muss, erkläre, welche Software fehlt, welche Auswirkungen das hat und was als Nächstes zu tun ist. Behandle nur das aktuelle Hindernis – wirf dem Benutzer keine vollständige Umgebungsliste zu.

Einstiegssatz: „Du musst mir nur eine Geschichteidee geben, und ich verwandle sie in Chats, Benachrichtigungen und Töne auf dem Handy. Ich prüfe zuerst die Produktionsumgebung, erstelle dann eine abspielbare Vorschau für dich.“ Wenn der Benutzer bereits eine Geschichte gegeben hat, arbeite direkt daran weiter – fordere nicht erneut eine an.

Standardeinstellungen (direkt übernehmen; frage nur nach wirklich fehlenden Informationen, die die Produktion beeinflussen)

  • Der Benutzer kann möglicherweise nicht programmieren. Alle Befehle führst du aus – lass den Benutzer keine Abhängigkeiten installieren, Skripte ausführen oder Code ändern. Wenn Python-Pakete fehlen, installiere sie selbst mit pip install. Wenn Software wie ffmpeg, Browser oder Jianying fehlt, teile dem Benutzer in einem Satz mit, was installiert werden muss und wo es heruntergeladen werden kann.
  • Der Benutzer liefert die Geschichte, du kümmerst dich um Oberflächen, Animationen, Ton und Export. Wenn der Benutzer bereits Screenshots hat (z. B. in GPT erstellt), verwende diese. Wenn nicht, erstelle sie mit dem HTML-UI-Kit. Avatare, Tapeten, Gesichter und andere Fotomaterialien bitte den Benutzer mit einem Bildgenerierungsmodell zu erstellen; du gibst die Prompts (siehe references/image_prompts.md).
  • Jianying ist optional. Ohne Jianying wird trotzdem eine MP4-Datei und sechs separate WAV-Spuren geliefert.
  • System: Windows oder macOS. Sprache wird mit systemeigener TTS verwendet (Windows OneCore, macOS say). Nur unter Windows + Jianying Professional 11.8 getestet. Für Mac und CapCut muss dem Benutzer mitgeteilt werden, dass es nicht getestet wurde.

Grundlegende Prinzipien

  1. Geliefert wird ein abspielbares Video mit Ton. Skripte, Screenshots, stumme Spuren und Pläne gelten nicht als abgeschlossen.
  2. Ohne Hörprobe schreibe „nicht gehört", ohne Messung „nicht gemessen", Jianying-Entwürfe, die nicht tatsächlich geöffnet wurden, schreibe „zu prüfen“. Fälsche keine Projekte und keine Prüfergebnisse.
  3. Bereits bestätigte Einstellungen werden nicht wiederholt erfragt. Bei Zweifeln an der Materialversion prüfe selbst die Bildinhalte oder Prüfsummen.
  4. Das Bild zeigt nur den Handybildschirm: Kein Handyrahmen, keine Finger, keine Klick-Kreise, keine Maus, kein Zoom. Nicht strecken: 1170×2532, 30fps.
  5. Der Horror kommt aus dem Alltäglichen: Keine übernatürlichen Elemente, keine Glitch-Text-Effekte, keine Jump-Scares, kein Voice-Over, keine erklärenden Untertitel. Bei Tod oder Selbstmord zeige keine Art und Weise, nur ausbleibende Antworten, vergehende Zeit und eine ferne Sirene als Andeutung.
  6. Textdichte Oberflächen werden nicht an Text-zu-Video-Modelle übergeben, sondern vollständig deterministisch synthetisiert (PIL). Nur lokale Bereiche wie Gesichtsfenster können animiert werden.
  7. Vom Benutzer geöffnete Jianying-Entwürfe werden niemals überschrieben. Neue Versionen erhalten einen neuen Namen (z. B. _GrobschnittV4, _Finalfilm2).

Produktionsablauf

1. Brief

Nimm zuerst die Geschichte in einem Satz oder in einem Absatz Alltagssprache an. Verwende bei Bedarf die kurze Eingabevorlage aus references/brief_template.md; verwende die vollständige Vorlage nur, wenn der Benutzer eine detaillierte Planung wünscht. Personen, Bildschirmtexte, Szenen und Töne werden von dir strukturiert. Fehlende Teile werden mit sinnvollen Standardeinstellungen ergänzt, und die Annahmen werden kurz erläutert. references/brief_example.md enthält den vollständigen Brief von „Bewerbung beendet" (die dort angegebene „ca. 90 Sekunden" Laufzeit wurde später durch Feedback verworfen).

2. Projektstruktur einrichten

<Projekt>/project.json        Von templates/project.json kopieren, title, voices ausfüllen
<Projekt>/00_ui/              HTML-Oberflächen
<Projekt>/01_final_assets/    Alle Bilder (Engine findet sie anhand des Dateinamens, Dateiname ist projekteinheitlich)
<Projekt>/03_project/tools/   Kopiere alle scripts/ + ui_kit/ Ordner; scenes.py, tap_rects.py werden auch hier geschrieben

02_audio, 04_cache, 05_exports werden automatisch vom Tool erstellt. Alle Befehle werden in 03_project/tools ausgeführt. Schriftarten, Browser, TTS und Jianying-Entwurfverzeichnisse werden automatisch gesucht. Wenn nicht gefunden, werden sie in project.json angegeben (Feldbeschreibung siehe references/pipeline.md).

3. Oberflächenmaterial

  • HTML-UI-Kit (bevorzugt, siehe references/ui_kit.md): Jede Oberfläche eine HTML-Datei, speichere in 00_ui/S01/…. python ui_render.py rendert als 1170×2532 PNG, erzeugt automatisch _blank / _text Ebenen für Schreibmaschine, Klickbereiche .taps.json, Gesichtsfensterposition .ui.json. Chinesisch korrekt, Tastatur stimmt mit keyboard.py überein.
  • Mit Bildgenerierungsmodell erstellte Screenshots: Speichere in 01_final_assets/S01/…. Schreibmaschinenoberflächen werden mit engine.mask_layers in Ebenen zerlegt, Klickbereiche mit sheet.py als Koordinatengitter-Puzzle vermessen und in tap_rects.py geschrieben. Überprüfe jedes Schriftzeichen im Bild.
  • Nach dem Rendern lies einige PNGs mit Read, um sicherzustellen, dass Text, Layout und Tages-/Nacht-Thema korrekt sind.

4. Szenen schreiben

In tools/scenes.py jede Szene eine Funktion, Name muss S + zwei Ziffern sein (S01…S99), Vorlage und API siehe templates/scenes_template.py:

from scene import *

def S01():
    c = Scene('S01', mood='day_bright', k=1.5, music='calm')
    s = c.shot('wake'); fade_in(s, img('lock.png')); s.hold(img('lock.png'), 2.0 * c.k); c.add(s)
    c.hold('inbox', 'inbox.png', 1.6, 'notify', ('tap', 1.2))
    c.save()

if __name__ == '__main__': run(globals())

typ() Schreibmaschine (sichtbare Tastatur, Pinyin, Leertaste zum Einfügen), V() Sprache, apptrans.open_app/close_app App öffnen/schließen, engine.scroll/face/timer/xfade usw. Jeder Klick muss einen TAPS-Eintrag haben, sonst gibt es kein Drück-Feedback (beim Rendern wird [tap] no rect for … ausgegeben).

5. Vollständige Audioversion in niedriger Auflösung

YP_RES=proxy (Standard, 586×1268) rendere alle Szenen → python build_audio.py → python export.py <Name> proxy. Erstelle sofort eine vollständige Audioversion von Anfang bis Ende, nicht zuerst einen 30-Sekunden-Ausschnitt. export.py gibt Laufzeit, Einstellungsanzahl und Lautstärke (LUFS / Spitze) aus.

6. Selbstprüfung

  • python peek.py S04 erzeugt ein Rasterbild der Szene. Lies Szene für Szene mit Read: Text, Drückzustand, Tastatur, Übergänge, schwarze Frames.
  • Lies die von export ausgegebene Lautstärke. Du kannst den Ton nur numerisch messen – beim Bericht musst du angeben, dass nicht gehört wurde.

7. Lokale Änderungen nach Feedback

  • Tempo: Ändere k oder die Sekunden einzelner Einstellungen, rendere nur die betroffenen Szenen neu (python scenes.py S05 S07), dann build_audio + export.
  • Nur Ton ändern (Musik, Soundeffekte, Spracheeinstellungen): Kein Neu-Rendering der Bilder, direkt build_audio + export.
  • Oberflächentext oder Layout: Ändere HTML, dann python ui_render.py (rendere nur die geänderten neu), dann rendere die Szenen, die sie verwenden, neu.
  • Jede neue MP4-Datei erhält einen neuen Namen (export.py überschreibt keine gleichnamigen Dateien). Führe bei langen Projekten eine RECOVERY.md im Projekt (aktuelle Version, Befehle, Aufgaben) für den Fall, dass der Kontext unterbrochen wird.

8. Hohe Auflösung und Jianying

Nach Zufriedenheit des Benutzers setze YP_RES=hd und rendere alle Szenen neu (1170×2532, viel langsamer als niedrige Auflösung, kann szenenweise parallelisiert werden) → build_audio.py → export.py <Name> hd → wenn der Benutzer Jianying möchte, build_jianying.py <Name> hd.

  • build_jianying erstellt immer ein Projektpaket (05_exports/<Name>_Projektpaket/: Material, sechs Spuren, README.txt); schreibt nur den Entwurf, wenn pyJianYingDraft installiert ist; kopiert nur in das Jianying-Entwurfsverzeichnis, wenn es gefunden wird; verweigert die Ausführung bei gleichnamigem Entwurf.
  • Auf einem neuen Computer oder neuer Jianying-Version führe zuerst jy_roundtrip_test.py aus und bitte den Benutzer, den Testentwurf zu öffnen und zu bestätigen, ob er abspielbar ist.
  • Entwürfe werden vor dem Öffnen durch den Benutzer grundsätzlich als „zu prüfen" markiert. Unter Windows kann mit winshot.py das Jianying-Fenster zur Unterstützung erfasst werden.

Feedback aus dem ersten Werk (Standardmäßig bei neuen Projekten übernehmen)

Siehe references/lessons.md.

  • Tempo langsam halten: Die erste Version mit 94 Sekunden wurde als „zu schnell" bewertet, die endgültige Version mit 6 Minuten 45 Sekunden war zufriedenstellend. Verweile so lange, dass der Text lesbar ist. Besonders bei textdichten Seiten wie Formularen oder Bewertungen langsam vorgehen. Stelle zuerst die Lesbarkeit sicher, lass dich nicht von der im Brief angegebenen Gesamtlaufzeit binden.
  • Normale Geschwindigkeit: Tippen etwa 7,5 Anschläge pro Sekunde, nach jedem Wort eine Pause von 0,22 Sekunden; Sprache in normaler Sprechgeschwindigkeit, nicht beschleunigen, nicht abschneiden.
  • Jeder Klick muss eine sichtbare Änderung der Oberfläche bewirken (Button abdunkeln oder verblassen, Zeile hervorheben), sonst weiß der Zuschauer nicht, wo geklickt wird.
  • Beim Tippen muss die Tastatur sichtbar sein: Tastenanschlag, Pinyin mit Unterstrich Buchstabe für Buchstabe aufbauend, Kandidatenleiste ändert sich, Leertaste fügt das gesamte Wort ein. Zeichen dürfen nicht aus dem Nichts erscheinen.
  • Vom Desktop in eine App muss eine Öffnungsanimation erfolgen (App-Symbol vergrößert sich und klappt auf), zurück zum Desktop muss eine Schließanimation erfolgen.
  • Scrollgeräusche müssen deutlich sein.
  • Hintergrundmusik ist reine Instrumentalmusik: Anfangs entspannt mit Melodie, später Szene für Szene zunehmend unbehaglich, bis am Ende „unbehaglich genug". Unbehagen durch Materialänderungen, nicht nur durch Lautstärke.
  • Das Ende muss Zeitvergehen zeigen: Sperrbildschirm-Datum, Uhrzeit, Akkustand ändern sich Tag für Tag, Benachrichtigungen sammeln sich, Akku wird rot, schließlich entfernte Sirene (Beispiel siehe examples/yingpin/scripts/lockdays.py).

Referenzdateien

  • references/pipeline.md: Verwendung jedes Skripts, project.json-Felder, Soundereignisse, Hinweise zu Jianying.
  • references/ui_kit.md: Schreibweise des HTML-UI-Kits, Komponenten, Ebenen, Klickbereiche.
  • references/image_prompts.md: Prompts für Bildmodelle wie GPT, sowie wie man nach Erhalt des Bildes Ebenen trennt und Klickbereiche vermisst.
  • references/brief_template.md: Vorlage für den Benutzer zum Ausfüllen des Briefs.
  • references/lessons.md: Feedback aus der ersten Version des ersten Werks, Änderungen und technische Fallstricke.
  • references/brief_example.md: Der ursprüngliche Brief von „Bewerbung beendet".
  • examples/yingpin/scripts/: Szenenskript von „Bewerbung beendet" (scenes_v2.py enthält eine eigene typ/V, äquivalent zu scene.py) und spezielle Werkzeuge. Enthält nur Skripte, keine Screenshots des Originalfilms, kann nicht direkt ausgeführt werden, dient als Referenz für Einstellungsschreibweise.

Berichtsformat

Verwende Chinesisch, Standardsprache, keine Fachbegriffe stapeln. Sage klar: Was wurde geändert; Pfad und Laufzeit des fertigen Films; Lautstärkewerte mit Hinweis „nicht gehört"; Jianying-Entwurfsname und ob validiert; die in das Bild eingebrannten Texte können in Jianying nicht geändert werden, nur durch Neu-Rendern der Einstellung.

Verwandte Skills