Communitygithub.com

Piano Remotion — Partition Vidéo Piano

Créez des vidéos de partitions de piano avec sauts à deux mains, traînées lumineuses et caméra. Révisez la notation, réutilisez les outils audio échantillonnés, et arrêtez-vous pour approbation de la partition puis approbation des images clés / audition avant exportation.

Qu'est-ce que Piano Remotion — Partition Vidéo Piano ?

Piano Remotion est une compétence pour agents IA (compatible avec Claude Code, Cursor ou Codex) qui automatise la production de vidéos de partitions de piano de haute qualité. Elle gère l'extraction de notation à partir de fichiers MusicXML, MIDI, PDF ou images, avec une validation en deux étapes (approbation de la partition puis approbation des images clés). La compétence préserve les animations originales (sauts à deux mains, traînées lumineuses), utilise des outils OMR professionnels pour la reconnaissance, et ne procède à l'exportation qu'après approbation humaine explicite. Elle suit un workflow rigoureux : découverte des sources, révision de notation avec audit, enregistrement du consentement utilisateur, production audio par synthèse ou échantillonnage, et vérification des images clés avant exportation via Remotion.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add Fallonwong/piano-remotion

Demander à votre IA préférée

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

Documentation

Piano Remotion — V1.0.0

Lisez d'abord les remotion-best-practices officielles installées. Réutilisez les environnements autorisés compatibles ; Python/OMR sont optionnels. Les premières installations ou téléchargements importants nécessitent chemins, versions, contenu, taille/raison et permission utilisateur. Préservez les sources privées, les superpositions personnelles désactivées, les visuels originaux ScoreNoteLeap/PianoScoreScene. Aucune licence n'a été attribuée.

Utilisez node <skill>/scripts/piano.mjs. Lisez le flux audio et reconnaissance pour l'audio ou les PDF/images ; le flux de géométrie et rendu documente la géométrie et la mécanique de scène existante. Pour la réutilisation et l'installation à l'exécution, voir la configuration de l'environnement. Utilisez les preuves de production et les arguments de notation-audit avec ces commandes. N'utilisez pas les appels Demo hérités comme achèvement de chanson vérifié.

Exécuter la tâche avec deux arrêts de révision de contenu

  1. Découvrir/classifier. Réutilisez le projet actuel et les outils compatibles explicitement autorisés. Un PATH manquant ou un délai de sonde n'est pas une preuve d'absence. Les MusicXML/MIDI fiables ont priorité sur la re-reconnaissance. Les images PDF/portées préfèrent un OMR professionnel installé ; les outils manquants produisent des options, pas une transcription inventée. Jianpu nécessite une interprétation explicite de la tonalité/octave/rythme. N'écrivez jamais silencieusement un reconnaisseur par chanson ou ne simplifiez pas les voix.
  2. Préparer et réviser la notation. Conservez le MusicXML modifiable, la sémantique réelle hauteur/durée/mesure/repos/accord/voix/portée/liaison de tenue/liaison de phrasé. Vérifiez les recadrages originaux/reflux pour chaque mesure ; des barres équilibrées ne sont pas une correction. notation-audit ajoute les différences de révision, les mesures pilotes denses/connectées/polyphoniques et les doutes fondés sur des preuves. Utilisez --previous après les corrections et --expected-measures lorsqu'un utilisateur a identifié un changement limité. Montrez les changements inattendus ; ne réinitialisez pas une musique déjà correcte pour des modifications de caméra. Une nouvelle demande de score PDF/image nécessite --notation-audit. Montrez les recadrages/différences/doutes, retournez WAITING_FOR_SCORE_APPROVAL et TERMINEZ LE TOUR. L'auto-révision de l'agent ne peut pas approuver.
  3. Enregistrer le consentement réel de l'utilisateur. Citez les mots réels de l'utilisateur avec la référence requestId/message affichée ou utilisez sa réponse de page de révision. Ne fabriquez jamais actor=user ou approbation. La réponse de score enregistre fourni/synthétisé/silencieux ; le choix audio généré n'approuve pas un timbre non vu. Le JSON local lie les versions, pas l'identité humaine.
  4. Produire la chanson/l'audio approuvée. Préservez l'animation originale et la géométrie SVG native. Les liaisons de tenue de même hauteur sonnent une fois pendant toute leur durée ; les hauteurs liées par phrasé restent séparées ; les ligatures ne sont pas des liaisons. Découvrez avec audio-plan : d'abord l'enregistrement utilisateur, puis le moteur/police échantillonnés existants. audio-render exporte le XML approuvé complet via MuseScore Basic vérifié ; audio-master enregistre le gain global explicite/le padding et protège les queues de relâchement audibles. Une nouvelle liaison vérifiée nécessite --audio-evidence. N'enregistrez pas les formes d'onde générées par l'agent comme enregistrements utilisateur. Le synthesize --preview-only intégré n'est qu'un brouillon de calibration ; ne remplacez jamais l'audio de production par des oscillateurs personnalisés juste pour passer l'alignement.
  5. Afficher les images clés réelles et l'audition. Utilisez le même master/propriétés/tâche final de chanson complète pour l'aperçu/l'exportation. keyframes génère des images réelles et un court clip d'audition/mouvement. Montrez la source audio/profil/mix ainsi que les deux mains/accords/changements de ligne/connexions/caméra. Retournez WAITING_FOR_KEYFRAME_APPROVAL et TERMINEZ LE TOUR. Une audition facultative précoce du timbre est utile, pas une troisième barrière obligatoire. Un extrait de 10–15 s ne peut pas remplacer le master de chanson complète. Les changements audio/moteur/mix invalident cette révision.
  6. Exporter après les deux approbations. render --approval ... --confirmed utilise la tâche figée. --confirmed seul ne peut pas contourner la révision. Vérifiez les flux décodés, l'audibilité, la durée, le fps/la taille et les attaques sonores échantillonnées. Un pic d'énergie manquant n'est pas concluant pour une musique dense/légato : préservez le son et retournez needs_review ; ne raccourcissez jamais la décroissance ou ne modifiez pas les notes pour satisfaire le détecteur. Ne falsifiez pas un rapport réussi. Conservez les commandes, entrées et résultats réels.

Qualité et limites de la reconnaissance

Inspectez la qualité du scan, la provenance des pages/recadrages, les altérations/tonalité/clef/octave, les points/ligatures/groupements irréguliers, les repos, le nombre d'accords, les voix/mains et la liaison de tenue vs liaison de phrasé. Commencez les longues partitions difficiles par un pilote représentatif de 3 à 5 mesures ; recoupez avec une deuxième méthode existante lorsque utile. Une lecture deux fois par un modèle n'est pas une vérité terrain indépendante. Ne revendiquez jamais un pourcentage de précision sans référence corrigée par un humain. Conservez les preuves d'incertitude par mesure et expliquez chaque correction.

Deux échecs sur un même chemin nécessitent un diagnostic/des alternatives. Si aucun résultat révisable n'existe après environ dix minutes, signalez les blocages ; n'exécutez pas silencieusement une heure. Effectuez le travail de routine de manière autonome à l'intérieur de chaque étape ; ne demandez pas de micro-permission pour les étapes réversibles ordinaires ou les ajustements de mix autorisés.

Utilisez un adaptateur OMR professionnel installé lorsqu'il est disponible. Jugez la notation par rapport à la source originale ; une gravure réussie ou une exportation vidéo ne remplace pas la révision de la source. Voir utilisation et prompts. Préservez les tâches héritées pour inspection ; reliez les nouveaux travaux avec des preuves V1.0.0 plutôt que d'écraser les artefacts terminés.

Skills associés