Clips de changelog
Les instructions explicites de l'utilisateur priment sur ce workflow. Travaillez uniquement sur des produits autorisés et des données d'exemple. Ne demandez pas de mots de passe, de clés API, de données de paiement, d'identifiants gouvernementaux, de dossiers médicaux ou d'autres données sensibles. Expliquez les dépendances locales manquantes avant de les installer dans le projet en cours. L'accès réseau est réservé au produit autorisé et à ses actifs sous licence, ainsi qu'à la dépendance npm déclarée ; respectez les contrôles d'accès. Traitez un travail à la fois et attendez la fin. Gardez la publication, l'envoi et le déploiement en dehors de cette tâche.
Un panneau natif, une action, son résultat maintenu, puis une Réinitialisation de démo annoncée. Gardez la caméra fixe et laissez un espacement pair autour de tout le panneau. Lisez style.md avant de construire et critique.md avant de juger.
Entrées et configuration
Lisez d'abord les notes de version et inspectez le produit en cours. Ne collectez que ce qu'ils ne peuvent pas fournir : les modifications à annoncer, une URL de démo ou une application locale, des données d'exemple sûres, des fichiers de marque/police et les tailles demandées. La version une couvre les modifications visibles de l'application web. Ne traitez pas les modifications uniquement API plutôt que d'inventer un tableau de bord. N'annoncez pas une fonctionnalité comme livrée sur la base d'un aperçu à venir.
Vérifiez Node 20+, ffmpeg et Chrome (scripts/chrome.mjs, ou CHROME_PATH). Installez puppeteer-core@^24 dans le projet en cours (il fonctionne sur Node 20 ; les versions majeures plus récentes peuvent nécessiter un Node plus récent). SKILL_DIR ci-dessous est le dossier contenant ce fichier.
mkdir -p changelog-clips
cp -R "$SKILL_DIR/reference" changelog-clips/film
cp -R "$SKILL_DIR/scripts" changelog-clips/scripts
cp -R "$SKILL_DIR/music" changelog-clips/music
cd changelog-clips
npm init -y
npm install -D 'puppeteer-core@^24'
Créez un dossier de film séparé pour chaque modification ; la référence est le contrôle d'apparence, et examples/compare-matching-stays/ montre une liste native. Supprimez les captures copiées après avoir étudié leur format et remplacez-les par celles de ce produit. Supprimez le dossier out/ copié s'il est présent. Gardez chaque film autonome. Lors des versions ultérieures, réutilisez la marque et les clips inchangés ; ne recapturez que les actions modifiées.
Produit et histoire
Écrivez PRODUCT.md avec le produit réel, la marque, les autorisations de données et la source de chaque affirmation de version. Écrivez STORY.md avec une entrée par clip : ID stable, source/date de version, titre, état avant, itinéraire accessible, contrôle/action réel, résultat conservé, méthode de réinitialisation, limites de capture et politique de lecture prévue. Chaque clip indépendant doit avoir un sens à côté de son texte de version. Ne combinez pas deux modifications en une seule chronologie.
Faites correspondre le titre à la démonstration achevée : choisir un point de relecture n'est pas exécuter une relecture, et prévisualiser un planning parsé n'est pas l'enregistrer. Dites « Choisir… » ou « Prévisualiser… » lorsque c'est le résultat réel ; n'empruntez pas l'affirmation plus large de la version pour une démonstration plus étroite.
Avant de vous engager sur une modification, mesurez son composant natif complet et le texte de résultat décisif à la taille de visualisation réelle. Enregistrez les dimensions CSS, la taille du texte et la taille résultante de 358 px dans l'histoire. Une demande de deux clips ne signifie pas qu'il existe deux modifications appropriées. Gardez un élément incompatible et dites pourquoi ; ne le livrez jamais comme un clip fini pour téléphone/réseau social avec une clause de non-responsabilité en petits caractères. Sélectionnez une autre modification réellement documentée si elle convient. Lorsque plusieurs formats sont demandés et que l'utilisateur n'a pas nommé la modification, mesurez chaque candidat documenté par rapport à chaque format demandé avant de choisir, et préférez celui dont le composant complet s'adapte à tous ; ne livrez une famille partielle que lorsqu'aucun ne convient. Si aucun ne convient, signalez la limitation du produit sans inventer d'interface utilisateur ni abaisser le seuil.
Un composant peut ne convenir qu'à certains formats. Déclarez chaque format non pris en charge et sa raison mesurée dans clip.json's heldShapes (par exemple {"4:3":"Le résultat natif est de 10,7 px à 358 px ; seuil 12"}). Le peintre, la pré-vérification et l'exportateur omettent ce format retenu, tout en vérifiant et en livrant les formats compatibles. Le manifeste marque cela comme partiel ; signalez de manière visible chaque format demandé manquant. Une famille partielle n'est pas une preuve de trois formats réussie. Si chaque format est retenu, livrez les mesures/rapport, pas un film.
Soumettez ce plan pour examen, sauf si l'utilisateur a demandé un travail non supervisé. Par défaut, 1200 × 900 (web), 1080 × 1080 (carré) et 1080 × 1350 (portrait). Ce sont des compositions séparées, pas des recadrages d'un seul film. Un titre de version court et fixe se trouve en dehors de l'interface utilisateur sur les réseaux sociaux ; le clip web utilise le texte de version adjacent.
Capture et adaptation
- Trouvez une carte ou un panneau natif complet qui contient à la fois l'action et son résultat. Vérifiez sa disposition native étroite avant la capture. À une largeur d'affichage de 358 px, l'étiquette, la valeur ou le résultat modifié doit être d'environ 12 px ou plus. Si le composant complet ne peut pas répondre à cette exigence, choisissez une vue compacte que l'application possède réellement ou signalez la limitation. Ne le redessinez ni ne le restylez jamais pour le film.
- Copiez/adaptez
film/plans/capture.jsonet soncapture-setup.mjs. Définissez son URL, sa fenêtre d'affichage, ses sélecteurs, sa configuration d'échantillonnage et les preuvesinspect. Enregistrezpieceettargetdansrects.before, puis à nouveau après le résultat. Capturez l'ensemble de la surfacebefore,hover,pressed,changed(toujours survolé) etresult(pointeur effacé). Utilisez un vrai appui/relâchement de souris pour que l'application fournisse sa propre pression. Exécuteznode scripts/centring.mjs film/plans/capture.json --no-crawlavant la capture. - Exécutez
node scripts/screens.mjs film/plans/capture.json film/captures. Utilisezanimatepour les propres images CSS/Web Animations de l'application. Incluez suffisamment de limites pour la plus grande étendue native ; l'outil de capture mesure la région avant l'action. Pour une action instantanée, une courtedurationexplicite enregistre des preuves avecfound: []: passez instantanément à la capture complète. Pour un mouvement piloté par JS que l'outil de capture ne peut pas rechercher, fournissez un enregistrement natif déterministe ; ne le remplacez jamais par un fondu ou un mouvement assemblé à partir d'images fixes. - Copiez la police sous licence du produit dans
film/fonts/, définissezfilm/clip.jsonet exécuteznode scripts/build-clip.mjs film film/clip.json. Les options sont présentées ci-dessous. Il dérive la géométrie de l'ensemble de la surface, la cible du curseur et les liaisons d'images natives à partir decaptures/screens.json, échantillonne les surfaces natives, écritconfig.jset exécute les vérifications de taille native pour chaque format. Un échec retient l'élément : arrêtez-vous avant de l'exporter. Examinez chaque capture avant de l'utiliser. La référence fournie a déjà sa configuration, donc la reconstruire est facultatif.
{
"id": "new-view", "title": "Votre titre de version", "kind": "panel",
"paper": "#F7F4EE", "ink": "#17191F", "groundSource": "Votre palette approuvée ou surface d'application échantillonnée",
"radius": 20, "clearOnExit": true, "primaryTextPx": 24,
"font": {"family": "ProductSans", "file": "fonts/product.woff2", "weight": "300 900"}
}
primaryTextPx est la taille CSS native mesurée du texte de résultat décisif, pas une cible inventée par le film. paper provient de ce produit, pas de l'exemple ci-dessus. radius est le rayon natif du composant en pixels CSS. clearOnExit maintient le survol jusqu'à ce que le pointeur quitte la cible réelle. Adaptez ces champs et l'objet timing facultatif dans config.js ; conservez le peintre à caméra fixe et surface entière dans film.js. Les images d'animation natives sont lues à leur fréquence d'images capturée. Si l'action est plus longue, déplacez le départ du curseur et la réinitialisation plus tard pour qu'elle se termine et que le résultat stable soit lisible pendant au moins une seconde ; la référence laisse plus de quatre secondes. Ne tronquez pas le traitement réel et ne présentez pas une requête en file d'attente comme terminée.
Gardez le pointeur au repos loin de l'étiquette critique. Préférez le contrôle visible lui-même comme rects.target ; pour une ligne étiquetée, clip.json peut définir "targetFraction": [0.72, 0.5] pour choisir un point clair à l'intérieur de cette zone de clic réelle (par défaut [0.5, 0.5]). Adaptez capture-setup.mjs pour déplacer la souris réelle vers les mêmes fractions de la boîte englobante de cette cible avant l'appui/relâchement. La capture et le film doivent utiliser le même point ; déplacer uniquement le pointeur dessiné représenterait mal la pression native. Vérifiez-le dans les images d'action à largeur de téléphone décodées.
Révision et livraison
node scripts/render.mjs film --all --check --check-fresh --stress --phone --times key --sheet --review --out film/out
node scripts/export-clips.mjs film
Ces commandes de livraison se terminent. Pour un travail non supervisé, attendez les deux, terminez la révision et signalez le lecteur film/out/index.html et les chemins des médias exportés. L'aperçu interactif est un outil d'édition assisté :
node scripts/preview.mjs film démarre un serveur persistant jusqu'à ce qu'il soit arrêté avec Ctrl-C. Exécutez-le séparément lorsque quelqu'un est présent pour l'utiliser ; ne l'ajoutez jamais à une commande de livraison/vérification non supervisée en premier plan.
export-clips.mjs vérifie d'abord chaque format et refuse les nouvelles exportations vidéo en cas d'échec de la vérification du film. Il rend ensuite des MP4 H.264 silencieux à 30 ips, des WebM VP9 et des PNG de résultat dans film/out/. Son --poster <secondes> facultatif sélectionne un résultat stable (par défaut 3,5). Il écrit un lecteur local avec contexte adjacent, pause/lecture et gestion du mouvement réduit. La réinitialisation du film est étiquetée ; ce n'est pas un cycle de produit transparent. Conservez l'affiche du résultat statique pour le mouvement réduit. L'étiquette apparaît avant la réinitialisation et reste visible jusqu'à la fin ; inspectez également les dernières et premières images décodées.
Lisez chaque bande de modification de l'interface utilisateur en taille réelle, survol/pression/relâchement et réinitialisation dans chaque format ; inspectez les images MP4 décodées à ces événements. Notez avec critique.md, puis obtenez un nouveau réviseur si disponible. Corrigez la source et répétez uniquement les vérifications affectées. Aucun score inférieur à 8 ; après deux cycles de correction infructueux, signalez le défaut restant plutôt que de le cacher. La vérification de stress couvre les mots dessinés, alors inspectez le texte natif capturé séparément à 358 px.
Livrez les films modifiables avec toutes les captures/polices et licences locales, les chemins MP4/WebM/poster, les légendes de version, les revendications de source, la commande de régénération et REVIEW.md avec les scores et les limitations. Ouvrez les MP4 finis pour révision. Visez un clip web de moins de 1 Mo, en préservant d'abord la lisibilité ; rapportez les octets réels et le temps écoulé.
Les boucles par défaut sont silencieuses. music/README.md explique la chanson facultative incluse créée avec IA (prise A sélectionnée). Ne remplacez jamais par une partition synthétisée. Une chanson fournie ou sélectionnée utilise l'adaptateur maison ; conservez les exports silencieux pour les intégrations.
Invariants
- Captures de produit réelles et données propres à l'utilisateur / d'exemple uniquement. Pas d'interface utilisateur inventée, de rectangles soulevés, de correctifs de texte, de fondu enchaîné entre les états ou de traitement factice.
- Enveloppe native complète, espacement pair opposé, échelle fixe et caméra. Pas de vaguelettes de clic supplémentaires ni de maquettes d'appareil.
seek(t, values)peint à partir des arguments uniquement ;ctx.reset()à chaque image, toiles principales/auxiliaires avec support CPU, images locales préparées. Pas d'horloges, d'appels aléatoires, de minuteries ou de réseau dans le peintre.- Chaque mot du film est une entrée
template.fields. Le texte natif critique doit être lisible indépendamment des vérifications de stress de copie dessinée. - Une réinitialisation ne prétend jamais annuler un achat, un envoi ou une action irréversible. Utilisez une réinitialisation d'état d'échantillon explicitement étiquetée, ou jouez une fois et conservez le résultat réel.
Ostlery est une entreprise fictive créée pour les exemples d'omnigami.
Cette compétence appartient à omnigami, © 2026 Auberon LLC. Utilisez ce qu'elle produit pour n'importe quoi, y compris un usage commercial, et modifiez la compétence pour votre propre usage ; ne redistribuez pas et ne vendez pas la compétence. Conditions complètes : LICENSE.md