What's New-Clip
Ein What's New-Clip zeigt den Leuten in der Zeit, die sie zum Vorbeiscrollen brauchen, was ein Release geändert hat: eine Startkarte, die jedes Release dieselbe Frage stellt und die Version zeigt, eine Szene pro Änderung, gefilmt auf dem echten Release-Build mit ihrer Bildunterschrift, und eine Endkarte, die sagt, wo es zu bekommen ist. Die Worte kommen zuerst und sind die eigenen des Genehmigers. Du filmst von einem gesäten, wiederholbaren Zustand aus, renderst mit einem Befehl und siehst dir Standbilder deines eigenen Renders an, bevor irgendeine Person ihn sieht. Der Spezifikationsstand bleibt im Repository, sodass das nächste Release von diesem ausgeht, statt von einer leeren Bearbeitungssitzung.
Projektfakten stehen in docs/agents/whats-new-clip.md im Repository des Benutzers: wo die Release-Notes sind, wie der Release-Build gebaut und gesät wird, wie diese Oberfläche erfasst wird, das Aussehen, die Formate, wo Clips aufbewahrt werden und wer genehmigt. Wenn diese Datei fehlt, befolge zuerst SETUP.md.
Das Werkzeug ist scripts/clip.py. Führe es aus als uv run <Ordner dieser Fähigkeit>/scripts/clip.py <Befehl>; --help bei einem beliebigen Befehl listet seine Flags auf. Es benötigt ffmpeg und ffprobe im PATH; uv bringt Pillow mit. Ohne uv erstelle eine virtuelle Umgebung außerhalb des Repos (python3 -m venv <Verz> && <Verz>/bin/pip install pillow) und führe das Werkzeug mit <Verz>/bin/python aus. Das Format der Spezifikation und jede Regel, die check anwendet, stehen in SPEC.md.
1. Finde, was die Leute bemerken werden
Lies die Release-Notes dort, wo die Projektdatei sie angibt. Liste jede Änderung auf, die eine Person sehen, hören oder fühlen wird, jede verknüpft mit ihrer Zeile in den Notizen. Lasse Korrekturen weg, die niemand bemerkt, und Arbeiten hinter den Kulissen.
Wenn nichts auf der Liste für die Benutzer bemerkbar ist, frage den Genehmiger, ob dieses Release überhaupt einen Clip bekommt, und höre auf, es sei denn, sie sagen ja.
Erledigt, wenn: jeder Eintrag auf der Liste auf eine Zeile in den Release-Notes verweist oder der Genehmiger gesagt hat, dass es für dieses Release keinen Clip gibt.
2. Stimme die Worte ab
Schlage eine Bildunterschrift pro Änderung vor, in der Reihenfolge, in der sie gezeigt werden, die stärkste zuerst. Eine Änderung pro Szene. Eine Bildunterschrift ist der Nutzen für eine Person in einfachen Worten, kurz genug, um sie zweimal zu lesen, während ihre Szene läuft (etwa sechs Wörter). Wenn der Genehmiger bereits Worte für eine Änderung gegeben hat (in den Notizen, einer Nachricht, dem In-App-What's-New), verwende sie wörtlich: ihre Rechtschreibung, Grammatik und Groß-/Kleinschreibung.
Frage den Genehmiger einmal, mit der gesamten Liste und deiner Empfehlung für jede Zeile, damit eine Ein-Wort-Antwort ausreicht. Filme nichts, bevor die Worte vereinbart sind: Eine umformulierte Bildunterschrift erfordert oft eine andere Aufnahme.
Wenn der Genehmiger eine Bildunterschrift umformuliert, die das Produkt ebenfalls zeigt (ein In-App-What's-New-Blatt, Store-Release-Notes), frage, ob dieser Text ebenfalls geändert wird, damit das Release mit einer Stimme spricht.
Erledigt, wenn: der Genehmiger jede Bildunterschrift genehmigt hat und du jede genau wie vereinbart hast.
3. Schreibe die Spezifikation
Wenn die Einrichtung bereits die Spezifikation dieser Version geschrieben hat, fülle diese Datei aus. Andernfalls beginne mit der Spezifikation des letzten Releases, sodass das Aussehen, die Eröffnungszeile und die Endkarte übernommen werden:
clip.py init <Version> --out <Spezifikationsordner> --from <Spezifikationsordner>/<letzte Version>.json
Für einen ersten Clip verwende --produkt "<Name>" statt --from. Fülle für jede Szene deren caption (wörtlich aus Schritt 2), words_by (wer die Worte gab) und ein geplantes in und out aus, das lang genug ist, um ihre Bildunterschrift zu lesen. Eine Änderung, bei der es nichts zu sehen gibt, erhält die kürzeste Szene, die ihre Bildunterschrift erlaubt. Führe dann clip.py check <Spezifikation> --words aus.
Erledigt, wenn: check --words check: ok ausgibt.
4. Nimm jede Szene auf
Nimm jede Szene gemäß den Regeln in FILMING.md mit den Build-, Seed- und Erfassungsbefehlen der Projektdatei auf. Zeige nur, was dieses Release enthält: nichts hinter einem Schalter, der ausgeliefert ist, nichts vom nächsten Release.
Wenn echte Eingaben über die eigene Benutzeroberfläche des Produkts eine Änderung nicht erreichen können, halte an und teile dem Benutzer mit: Das ist ein Fehler, und ein Clip, der daran vorbei gefilmt wird, würde versprechen, was die Leute nicht tun können.
Eine Änderung, die die Erfassung des Projekts überhaupt nicht filmen kann (eine Kameraansicht, ein zweites Gerät), wird von einem aufbewahrten Film gezeigt: siehe „Was die Erfassung nicht filmen kann" in FILMING.md.
Lege die Filme in den Clip-Ordner dieses Releases außerhalb des Repos. Setze für jede Szene source, in und out aus der Zeit, zu der jeder Schritt während seiner Ausführung protokolliert wurde, und schau nach, bevor du einer Markierung traust:
clip.py peek <Film> --from <Sekunde> --to <Sekunde> --out <einen frischen Scratch-Ordner> --sheet <Scratch-Ordner>/peek.png
Es zeigt den Film zwischen zwei seiner Sekunden so, wie render ihn lesen wird. Ziehe dieses Standbild niemals mit einem eigenen Seek: Eine Bildschirmaufnahme hält nur dort einen Frame, wo sich das Bild geändert hat, daher landet ein Seek auf der nächsten Änderung, die Sekunden später sein kann.
Führe dann clip.py check <Spezifikation> --media <Filme-Ordner> aus.
Erledigt, wenn: check mit --media, das auf die Filme zeigt, check: ok ausgibt.
5. Rendern
clip.py render <Spezifikation> --media <Filme-Ordner> --out <Clip-Ordner>/<Produkt, kebab-case>-<Version>-9x16.mp4
Rendere jedes weitere Format, das die Projektdatei mit --size nennt, z. B. --size 1920x1080. Wenn render sagt, dass ein Bildschirm bei dieser Größe zu klein zum Lesen ist (ein Telefonbildschirm in einem breiten Rahmen), benötigt dieses Format eine eigene Spezifikation: siehe „Ein weiteres Format" in SPEC.md. Ton ist optional und trägt niemals die Botschaft: Die meisten Leute schauen stummgeschaltet, daher müssen die Bildunterschriften allein die Geschichte erzählen.
Erledigt, wenn: render für jedes Format, das die Projektdatei nennt, Wrote ... ausgegeben hat.
6. Reviewer-Durchlauf
Ziehe Standbilder in einen frischen Ordner: clip.py stills <Clip> --spec <Spezifikation> --every 1 --safe --out <Scratch-Ordner> --sheet <Scratch-Ordner>/sheet.png. Es schreibt ein Standbild aus der Mitte jeder Karte und Szene, eins pro Sekunde, und ein Blatt mit allen, wobei die Ränder, die ein Feed abdeckt, getönt sind. Überprüfe jedes einzelne gegen REVIEW.md, für jedes Format.
Wenn dein Gestell einen Unteragenten starten kann, gib diesen Durchlauf an einen, der mit einem frischen Kontext gestartet wird und nur REVIEW.md, die Spezifikation, die Standbilder und das Blatt enthält: Er sieht, was auf dem Bildschirm ist, nicht, was du filmen wolltest.
Behebe jeden Befund so, wie es die Tabelle in REVIEW.md sagt, rendere dann erneut und ziehe die Standbilder noch einmal. Erkläre niemals ein falsches Bild in der Übergabe weg.
Erledigt, wenn: jedes Standbild jeden Punkt in REVIEW.md besteht und keine Korrektur aussteht.
7. Übergeben
Sende dem Genehmiger, was REVIEW.md unter „Die Übergabe" auflistet, auf die Weise, die die Projektdatei angibt, und bitte um ein OK oder darum, was geändert werden soll. Der Clip wird nicht veröffentlicht und keinem Release hinzugefügt, bis sie OK sagen. Das Veröffentlichen erledigt, wer in der Projektdatei genannt ist.
Bei einem Nicht-OK nimm ihre Änderungen zurück zu Schritt 2 (Worte) oder Schritt 4 (Bilder) und filme nur die Szenen neu, die sich ändern. Ein Nicht-OK ohne Grund: Frage einmal, was ihnen nicht gefallen hat, bevor du dieselben Aufnahmen erneut schneidest.
Erledigt, wenn: der Genehmiger OK gesagt hat oder ihre Änderungen wieder in Schritt 2 oder 4 sind.
8. Hebe es für das nächste Release auf
Die Spezifikation bleibt zusammen mit den anderen Änderungen des Releases im Repository. Bewahre die Filme neben den genehmigten Clips im Clip-Ordner auf. Füge jede Lektion, die dieser Clip gelehrt hat, als eine Zeile unter „Lektionen" in der Projektdatei hinzu.
Erledigt, wenn: die Spezifikation im Repository ist, die Filme neben den genehmigten Clips liegen und jede neue Lektion eine Zeile in docs/agents/whats-new-clip.md ist.