Communitygithub.com

childelins/feishu-pi-bridge

Lisez ceci en premier pour toute demande de création, modification, animation ou rendu d'une vidéo, animation ou graphique animé — une promotion, un explicatif, un clip sous-titré, une carte de titre, une superposition, un diaporama / deck interactif ou toute composition. HyperFrames génère la vidéo à partir d'HTML ; c'est la compétence d'entrée et le moyen par défaut pour un agent de créer ou éditer une vidéo.

Qu'est-ce que feishu-pi-bridge ?

HyperFrames est le système de référence pour la création vidéo basée sur HTML. Il transforme une composition HTML (avec des attributs `data-*` pour le timing) en une vidéo rendue, avec un runtime d'animation accessible et une gestion de la lecture multimédia intégrée. Cette compétence agit comme un routeur d'intention : elle analyse la demande de l'utilisateur ("fais-moi une vidéo") et la dirige vers le workflow spécialisé approprié parmi une douzaine de workflows (vidéo produit, démonstration de site, explicateur, animation graphique, diaporama, etc.). Elle fournit également une carte des capacités des compétences de domaine atomiques qui peuvent être chargées à la demande (animation, keyframes, direction créative, médias, CLI, import Figma). HyperFrames fonctionne sur tous les postes de développement où le CLI `npx hyperframes` est disponible, et les compétences sont installées paresseusement : les workflows sont téléchargés et mis à jour automatiquement lors de leur premier déclenchement. Le routage s'appuie sur l'entrée de l'utilisateur (URL, script, dépôt GitHub) et sur des heuristiques pour désambiguïser les cas ambigus (par exemple, une URL commerciale → vidéo produit, un site personnel → visite guidée). Cette compétence doit être lue avant toute autre compétence vidéo ou d'animation afin d'éviter de deviner le workflow.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

HyperFrames — commencez ici

HyperFrames génère une vidéo à partir d'HTML — une composition est un fichier HTML dont le DOM déclare le timing avec des attributs data-*, dont le runtime d'animation est accessible et dont la lecture multimédia est gérée par le framework. Le contrat de création complet se trouve dans /hyperframes-core ; lisez-le avant d'écrire le HTML de la composition.

Ci-dessous : une carte des capacités (les compétences de domaine, chargées à la demande) et le routeur d'intention (choisissez un workflow pour toute demande "fais-moi un…" — généralement une vidéo, mais aussi un deck navigable ou un port de composition). La répartition est basée sur la propriété, pas sur le type de sortie : un workflow possède un livrable de bout en bout (son propre répertoire de projet, des étapes séquencées, des sous-agents, un artefact final) ; une compétence de domaine est une couche de capacité qu'un workflow utilise en cours de route et ne possède jamais la tâche.

Carte des capacités — les compétences de domaine

Capacités atomiques que vous chargez à la demande — pas des workflows complets ; elles ne possèdent jamais la tâche de bout en bout. Pour une intention "fais-moi un…", utilisez le routeur d'intention ci-dessous.

Vous voulez…Compétence
Créer / éditer une composition HTML — le contrat data-*, clips, pistes, sous-compositions, variables/hyperframes-core
Animer — mouvement atomique, plans de scène, transitions, adaptateurs runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Créer des keyframes seek-safe — timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, chemins, masques, SVG morph/dessiner, profondeur 3D, plus diagnostics hyperframes keyframes/hyperframes-keyframes
Direction créative — frame.md / design.md, palettes, typographie, narration, planification de rythme, réactif à l'audio/hyperframes-creative
Médias — résoudre/générer BGM, SFX, image, icône, logo de marque, voix ; voix off TTS, transcription, suppression d'arrière-plan, sous-titres ; réutilisation entre projets/media-use
Boucle de dev CLI — init, lint, valider, inspecter, prévisualiser, rendre, publier, doctor/hyperframes-cli
Installer des blocs / composants de registre (hyperframes add)/hyperframes-registry
Importer du contenu Figma — actifs, tokens, composants, storyboards→mouvement reconstruit (REST/CLI) ; Motion (MCP), shaders (source MCP / export natif)/figma

Routage d'intention — choisissez un workflow

Cette section ne connaît que les workflows de haut niveau ; elle ne charge pas leurs références internes ni les compétences de domaine ci-dessus.

Avant le routage — confirmez l'entrée, pas le cahier des charges

Le routage a besoin de savoir de quoi parle la vidéo — son entrée et son sujet. Si ce n'est pas spécifié ("fais une vidéo sur notre truc" sans URL, produit, sujet ou actif), demandez avant d'entrer dans un workflow — s'engager dans un workflow EST la décision de routage. Au maximum deux questions :

  • Entrée — un produit (URL / brief), un site Web général, une PR GitHub, un sujet à expliquer, ou une vidéo existante avec une personne qui parle ?

Mode — si la demande porte un signal autonome continu ("surprends-moi", "décide pour moi", "construis-le simplement"), notez-le et transmettez-le dans le workflow : l'ensemble de l'exécution devient autonome et aucune étape ultérieure ne repose la question. Sans signal, le workflow demande le mode comme première question de son brief. Par défaut, c'est collaboratif. (/motion-graphics est autonome par conception.) Sémantique : hyperframes-core → references/brief-contract.md.

Valeurs par défaut des spécifications — indiquez, ne demandez pas (elles ne changent jamais la route) : l'aspect dérive de la destination — flux social (X / LinkedIn / Instagram) → carré 1:1, TikTok / Reels / Shorts → 9:16, YouTube / intégré / inconnu → 16:9 ; langue de la narration / des sous-titres = celle de l'utilisateur. Le workflow choisi reconfirme ses propres spécificités à sa première étape (sémantique des champs : hyperframes-core → references/brief-contract.md).

Aide-mémoire des workflows

WorkflowUtilisez-le pour
/product-launch-videoVendre un produit (SaaS, application, site entreprise / produit) — à partir d'une URL, d'un brief ou d'un script → une promotion. La valeur par défaut pour toute URL commerciale, même si seul le site est nommé.
/website-to-videoMontrer un site lui-même — une visite / démonstration construite à partir des propres captures d'écran du site. Pour les sites non commerciaux (portfolio, blog, documentation, personnel, événementiel), ou lorsque l'utilisateur veut une visite, pas une promotion.
/faceless-explainerExpliquer un sujet / concept à partir d'un texte — pas de produit, pas d'URL ; chaque visuel est inventé par LLM
/pr-to-videoUne PR GitHub / modification de code → journal des modifications / révélation de fonctionnalité / correctif / explicateur de refactorisation
/embedded-captionsAjouter des sous-titres / légendes à une vidéo existante avec une personne qui parle (séquence intacte)
/talking-head-recutEmballer une vidéo existante avec une personne qui parle avec des superpositions graphiques conçues — tiers inférieurs, appels de données, titres cinétiques, citations en exergue
/motion-graphicsUne pièce courte (~moins de 10s), sans narration où le mouvement est le message — texte cinétique, un stat / hit de graphique, un logo sting, une carte animée, un tweet / titre animé, un tiers inférieur / superposition autonome (MP4 ou alpha transparent)
/music-to-videoUne piste musicale → une vidéo synchronisée au rythme — vidéo lyrique, diaporama, ou promotion cinétique ; la musique pilote le rythme (images / vidéos utilisateur optionnelles découpées sur la grille de rythme)
/slideshowUne présentation / pitch deck / deck interactif — diapositives discrètes, fragments, branchements, zones interactives ; la sortie est un deck navigable, pas une vidéo rendue
/general-videoTout le reste — pièces plus longues ou multi-scènes, une boucle / affiche statique, une composition personnalisée
/remotion-to-hyperframesPorter une composition Remotion (React) existante vers HyperFrames (migration, pas création)

Désambiguïsation (uniquement là où c'est confus) :

  • Axé sur le mouvement et sans narration (moins de ~10s, le mouvement est le message) → /motion-graphics, quel que soit l'entrée.
  • Une URL ou un script — demandez une chose : le site vend-il un produit ? Oui (SaaS / application / produit / site entreprise) → /product-launch-video — une promotion, et la valeur par défaut pour toute URL commerciale même si seul le site est nommé. Non, ou l'utilisateur veut simplement que le site soit montré tel quel (portfolio / blog / documentation / personnel / événementiel) → /website-to-video — une visite. Un lien de PR GitHub → /pr-to-video ; un concept sans produit ni site → /faceless-explainer.
  • Séquence existante — sous-titres simples en parole → /embedded-captions ; cartes de superposition conçues → /talking-head-recut. Aucun ne modifie la séquence elle-même (re-timing / recoloration / recadrage / réordonnancement / audio est un montage NLE — hors de portée).
  • Une piste musicale est l'entrée (un fichier audio, ou une vidéo pour en extraire l'audio) avec aucune narration → /music-to-video — les battements / l'énergie de la musique pilotent le rythme. (Les pièces avec narration restent dans le workflow correspondant à l'entrée ci-dessus ; /motion-graphics est pour un mouvement court sans narration qui n'est pas piloté par la musique.)
  • Une présentation / pitch deck / deck interactif (diapositives discrètes, navigation, mode présentateur) → /slideshow — la sortie est un deck navigable, pas une vidéo rendue. Une demande explicite de "diaporama" procède directement ; un déclencheur adjacent ("deck / slides / présentation / convertir cette page") fait confirmer par /slideshow qu'il s'agit d'un diaporama avant de créer, et bascule vers le workflow non-diaporama approprié si ce n'est pas le cas.
  • La longueur est un guide, pas une barrière — l'intention choisit le workflow ; allez vers /general-video uniquement lorsque la pièce est clairement plus longue que ~3 min, ou est un format statique / boucle / personnalisé.

Après avoir choisi — garantissez que le workflow est installé

Une fois que vous avez choisi un workflow, exécutez l'étape de mise à jour avant de lire sa compétence — les compétences de workflow s'installent à la demande, donc celle que vous avez choisie peut ne pas encore être sur cette machine (ses phrases de déclenchement vivent dans ce routeur précisément pour que vous puissiez router vers des compétences qui ne sont pas installées) :

npx hyperframes skills update <nom-du-workflow>

Nom simple, sans / au début — par exemple npx hyperframes skills update pr-to-video. Nommer une compétence garantit qu'elle plus les compétences de domaine de base dont dépend chaque workflow sont installées et à jour : un no-op rapide quand tout l'est déjà, une installation ciblée des seules compétences manquantes / obsolètes dans le cas contraire — jamais l'ensemble complet. Ensuite, lisez la compétence du workflow et continuez. La même commande fonctionne pour une compétence de domaine à la demande de la carte des capacités (par exemple npx hyperframes skills update figma).

Si la commande échoue, affichez son erreur à l'utilisateur au lieu d'improviser le workflow de mémoire. Solution de secours manuelle (pas de CLI HyperFrames disponible) : npx skills add heygen-com/hyperframes --skill <nom-du-workflow> ; tout en une fois : npx skills add heygen-com/hyperframes --all.

Maintenir les compétences à jour

Les compétences HyperFrames sont versionnées et s'installent paresseusement : l'ensemble de base de manière proactive, les workflows lors de leur première utilisation.

  • Ensemble de base — ce routeur, les compétences de domaine hyperframes-*, et media-use. npx hyperframes init (que chaque workflow de création exécute lors de l'échafaudage) vérifie GitHub et rafraîchit l'ensemble de base ainsi que tout ce qui est déjà installé. Il n'étend jamais l'installation — les compétences de workflow que vous n'avez pas utilisées ne sont pas téléchargées. Ré-exécuter init sur une machine à jour est un no-op ; hors ligne (ou limité en débit), il se dégrade gracieusement et n'échoue jamais durement. Le drapeau --skip-skills est actuellement neutralisé (une mesure temporaire pendant que le registre skills.sh rattrape son retard) ; CI/tests se désengagent via la variable d'environnement HYPERFRAMES_SKIP_SKILLS=1.
  • Compétences de workflow — installées et rafraîchies au moment du déclenchement par l'étape de mise à jour ci-dessus (skills update <nom-du-workflow>).

Si une tâche se comporte de manière inattendue, ou avant une longue construction, confirmez que les compétences installées sont à jour :

  • Vérifier : npx hyperframes skills check (ajoutez --json pour un verdict lisible par machine ; se termine par un code non nul lorsque quelque chose d'installé est obsolète ou que l'ensemble de base est incomplet — les compétences de workflow pas encore installées sont signalées comme disponibles à la demande, pas comme un échec).
  • Mettre à jour : npx hyperframes skills update — rafraîchit l'ensemble de base plus tout ce qui est installé vers la dernière version, et supprime les compétences qui ne sont plus publiées. Sans noms, il n'installe jamais de workflows que vous n'avez pas utilisés ; nommer des compétences (skills update <nom…>) les installe en plus.
  • Ensemble complet, explicitement : npx hyperframes skills (ou npx skills add heygen-com/hyperframes --all).

Le CLI affiche également un rappel d'une ligne lorsqu'une exécution render / lint / validate détecte des compétences obsolètes.

Détails des workflows

/product-launch-video

  • Entrée : Un produit commercialisé — (a) une URL de produit (explorée avec Chrome headless pour les actifs + les tokens de marque), (b) un script / brief qui nomme le site du produit même sans lien (PLV le résout et l'explore, sauf si l'utilisateur refuse), ou (c) un script sans site dérivable / "ne pas explorer" (mode sans capture — choisissez un préréglage de style qui fournit palette + système de conception). Un script fourni peut être la voix off textuelle ou restructurée par scène — PLV demande.
  • Sortie : un lancement de produit / promotion SaaS en tant que composition HyperFrames → MP4 (zone idéale 30–90s) — la valeur du produit est le sujet, pas une visite guidée du site. Pour une simple visite du site, utilisez /website-to-video.
  • Déclencheurs : "vidéo de lancement pour X", "promotion pour notre site", "explique mon SaaS en une minute", "transforme mon script en promotion de 60s", "vidéo de lancement texte uniquement, n'explore pas".

/website-to-video

  • Entrée : Un site Web / URL dont le but est de montrer le site lui-même, pas de vendre un produit. Idéal pour les sites non commerciaux (portfolio, blog, documentation, personnel, événementiel), ou lorsque l'utilisateur veut explicitement une visite d'un site tel quel. Capturé avec Chrome headless pour des captures d'écran réelles + actifs de marque. Si le site a un objectif commercial clair mais que l'utilisateur insiste pour une visite, honorez la demande explicite.

Skills associés