gquthier/autonomous-sop-video

SOP-Video

Verwandle einen beobachteten Workflow in ein Video, das ein Anfänger ohne Raten nachvollziehen kann. Liefere bearbeitbare Quelle, MP4, Untertitel, Kapitel-Metadaten und einen kurzen Prüfbericht. Standardsprache ist die Sprache des Benutzers; verwende Deutsch, wenn angefordert. Das Standarddesign ist weiß, blau und zurückhaltend.

Beginne mit der tatsächlichen Anfrage

Lies die vorhandenen Briefings und Assets, bevor du Fragen stellst. Kläre nur Unbekannte, die das Ergebnis verändern: Aufgabe, Zielgruppe, Software/Version, Erzählmodus und Ausgabeziel. Respektiere eine Anfrage für einen Piloten, bevor du eine Serie produzierst.

Schreibe BRIEF.md im Ausgabeprojekt mit dem Ergebnis, das der Lernende erreichen soll, Voraussetzungen, Umfang, Sprache, Erzählung, autorisierten Aktionen und Lieferformaten. Eine Anfrage, ein Video zu erstellen/exportieren, autorisiert bereits die lokale Wiedergabe. Füge kein routinemäßiges Freigabe-Gate hinzu. Öffentliche Uploads und echte Kontenänderungen erfordern die entsprechende Autorisierung.

Weise einen verantwortlichen Produzenten zu

Wenn Delegation verfügbar ist, weise einen Produzenten-Agenten unter Verwendung von agents/producer.md zu. Gib ihm begrenzte Datei-Eigentümerschaft, das Briefing, Aufnahmeberechtigungen und Abnahmekriterien. Der koordinierende Agent prüft das Ergebnis und liefert es aus. Teile Szenen nicht auf mehrere Agenten auf, es sei denn, der Benutzer fordert parallele Produktion an.

Der Produzent darf ein verifiziertes Modell über eine verfügbare Agenten-Laufzeitumgebung oder ein Provider-CLI verwenden. Befolge references/models.md für Auswahl, einen kurzen Bewegungstest, Modellidentität und Nutzungsnachweise. Erfinde niemals eine Modellkennung oder benenne eine mehrdeutige Anfrage wie „O3.5“ stillschweigend um. Wenn die angeforderte Laufzeitumgebung nicht verfügbar ist, gib die Einschränkung an und verwende den aktuellen Agenten für die unabhängige Vorbereitung; frage nur, wenn eine erforderliche Modellauswahl die Produktion blockiert.

Ohne ein Delegationswerkzeug führe dieselbe Produzentenrolle im aktuellen Agenten aus und sage dies. agents/openai.yaml beschreibt die Erkennung; es erzeugt keinen Hintergrundagenten oder wählt automatisch ein Modell aus.

Produziere das Video

1. Beobachte die Vorgehensweise. Lese references/capture-and-audio.md. Verwende das erlaubte Browser/native Aufnahmewerkzeug, verbundene Sitzung, bereitgestellte Aufnahme oder verifizierte öffentliche Dokumentation. Zeichne den genauen Bildschirm, Schaltflächentext, native Bildabmessungen, Aufnahmedatum, UI-Variante und auf, ob eine Aktion tatsächlich ausgeführt wurde. Erfinde niemals UI für ein reales Produkt.
2. Schreibe das Lehrskript. Eine Aktion oder Entscheidung pro Takt: wohin gehen, worauf klicken, was prüfen, wie Erfolg aussieht. Gib die notwendige Voraussetzung und den häufigen Blockierungsfall. Vermeide, einen Klick zu erzählen, den das Video nicht zeigen kann. Füge für jeden ausführbaren Schritt und jedes geänderte Modal/Tab einen indikativen Screenshot hinzu; verwende einen Bildschirm mit neuem Zuschnitt, wenn das klarer ist.
3. Erstelle oder verwende zuerst die Stimme. Wähle ElevenLabs, eine autorisierte bereitgestellte/aufgenommene Stimme oder das verfügbare Erzählwerkzeug der Umgebung. Messe die tatsächliche Audiodauer, bevor du Szenen anordnest. Halte Stimme/Modell/Einstellungen über eine Serie stabil. Bewahre natürliche Pausen und füge genügend Haltezeit hinzu, um Schaltflächen zu inspizieren. Erzeuge niemals eine Stimme stillschweigend, wenn der Benutzer seine eigene Aufnahme ausgewählt hat.
4. Baue die visuelle Sequenz auf. Befolge references/production.md. Verwende den unten stehenden ausführbaren Starter oder passe das genehmigte Projekt an. Weißer #FFFFFF Hintergrund, blaue #1565D8 Titel/Akzente, marineblaue #102A43 Texte. Ein großer Screenshot nimmt die linke Seite ein; eine kurze Aktions-Checkliste bleibt rechts. Bewege die Kamera zu den tatsächlichen Schaltflächenkoordinaten, halte die relevante Beschriftung sichtbar und verwende einen Cursor/Halo. Füge erklärende Tafeln nur hinzu, wenn sie das Verständnis verbessern.
5. Füge Untertitel und Kapitel hinzu. Richte Untertitel an gemessener Sprache aus und teile sie in lesbare Hinweise auf. Lasse keinen Hinweis länger als seine Szene bestehen. Kapitel müssen dieselbe Zeitleiste wie das gerenderte Video verwenden; liefere Text/VTT-Kapitel und bette sie in das MP4 ein. Die Player-Kapitel-UI variiert, also behalte die Sidecar-Dateien bei.
6. Verifiziere und liefere aus. Führe die Manifest-Validierung und Renderer-Prüfungen durch, inspiziere jede Szene, beobachte die wichtigen Klick-Übergänge und verifiziere das exportierte MP4 separat. Berichte echte Einschränkungen und tatsächlich durchgeführte Aktionen. Eine existierende Datei ist kein Beweis für Wiedergabe oder korrekte Bildausschnitte.

Ausführbarer Starter

Das enthaltene Demo verwendet synthetische UI, explizit auf dem Bildschirm gekennzeichnet, und hat keine Erzählung. Es ist ein technisches Beispiel, kein Nachweis über eine echte Anwendung.

Voraussetzungen: Python 3.10+, Node.js kompatibel mit der ausgewählten HyperFrames-Version, FFmpeg/ffprobe und das unterstützte Chrome des Renderers. npx lädt den festgelegten Renderer bei erster Verwendung herunter; GSAP wird während der Kompilierung von seinem angegebenen CDN bezogen. Die lokale Vorschau/Wiedergabe erfordert kein ElevenLabs-Konto. Verwende die aktuelle Renderer-Dokumentation, wenn eine Abhängigkeitsprüfung fehlschlägt.

Aus dem Verzeichnis dieses Skills:

python3 scripts/sop.py init /path/to/new-sop
cd /path/to/new-sop
node build.mjs
npm run check
npm run preview -- --background
npm run render -- --quality delivery --output renders/video.mp4 --workers 1

Für GPU-Kodierung füge --gpu nur hinzu, wenn unterstützt. Der Starter legt eine getestete Renderer-Version zur Reproduzierbarkeit fest; überprüfe Upgrades, bevor du sie änderst. Wenn das HyperFrames-Skill installiert ist, verwende seine aktuellen Kompositions- und Verifikationsrichtlinien. Dieses Paket enthält den wesentlichen Vertrag und funktioniert ohne ein privates Skill-Verzeichnis.

Setze SKILL_DIR auf das installierte Verzeichnis dieses Skills, dann:

python3 "$SKILL_DIR/scripts/sop.py" validate sop.json --probe
python3 "$SKILL_DIR/scripts/sop.py" chapters sop.json --output delivery
python3 "$SKILL_DIR/scripts/sop.py" embed renders/video.mp4 delivery/chapters.ffmetadata delivery/video.mp4

init verweigert ein nichtleeres Ziel. embed verweigert das Überschreiben einer Ausgabe und kopiert Streams ohne Neukodierung. Siehe references/manifest.md für Felder und Timing. Das Hilfsprogramm erzeugt keine Stimmen, loggt sich nicht auf Websites ein oder lädt Dateien hoch.

Abnahmekriterien

• Der Lernende kann jede beschriebene Schaltfläche finden und den resultierenden Zustand sehen, oder einen klar angegebenen nicht ausgeführten/Beispiel-Zustand.
• Bildschirmdaten sind in den tatsächlich exportierten Pixeln anonymisiert. Öffentliche Quelle enthält nur genehmigte Assets; verpacke niemals private Rohaufnahmen, Anmeldedaten, Cookies oder Sitzungsdateien.
• Kleiner UI-Text bleibt bei der beabsichtigten Betrachtungsgröße lesbar; Zooms bewahren den Kontext. Keine Checklisten/Untertitel-Überlappungen oder unerklärliche Leerlaufzeiten.
• Audio hat keine abgeschnittene Sprache, abrupte Schnitte, fehlende Phrasen oder instabile Sprachwechsel. Verwende eine konsistente gemessene Lautstärke und inspiziere Spitzen.
• Untertitel und Kapitel stimmen mit der endgültigen Dauer überein. Der letzte Frame zeigt ein nützliches Ergebnis/Checkliste anstelle von versehentlichem Schwarz.
• Lieferung umfasst MP4, SRT, VTT, Kapiteltext/VTT, bearbeitbare Quelle, Screenshot-Herkunft, Modell-/Stimmnutzungsnachweise, sofern verfügbar, und einen QA-Bericht, der angibt, was tatsächlich getestet wurde.

Wenn Aufnahme, Erzählung, Wiedergabe oder Veröffentlichung blockiert ist, schließe die unabhängige autorisierte Arbeit ab und nenne die genaue fehlende Fähigkeit. Beschreibe kein Storyboard, keinen synthetischen Bildschirm und keine stille Vorschau als das fertiggestellte vertonte SOP.