Nelle parole della skill
Importa contenuti Figma in composizioni HyperFrames attraverso cinque fasi: asset statici, token di brand, componenti come HTML, timeline di motion e shader. Utilizza REST API ove possibile (asset, token, componenti) con connector opzionale per dati di motion e shader. Ogni importazione congela gli artifact localmente con provenance registrata, così i render non chiamano mai Figma e restano deterministici.
La ricostruzione dello storyboard tratta i frame come keyframe che descrivono lo stato di un elemento nel tempo, non come slide. Supporta il binding token-componente, così l'aggiornamento di una variabile di brand ricolora ogni componente importato. Attento ai rate limit, con retry automatico. Funziona su ogni file Figma a cui il token configurato può accedere.
Che cosa produce
- Asset immagine congelati sotto .media/images/ con provenance nel manifest e snippet img
- Voci di token di brand, sidecar figma-tokens.json e record binding-index in .media/figma-bindings.jsonl
- Pacchetti di componenti HTML editabili sotto compositions/components/<name>/
- Script timeline GSAP iniettati dopo i tag CDN, in pausa e finiti, registrati su window.__timelines
Come funziona
- 01Analizzare il Riferimento Figma
Usa parseFigmaRef per estrarre fileKey e nodeId dall'URL dell'utente, dalla stringa fileKey:nodeId o dal solo fileKey.
- 02Indirizzare in Base all'Intento alla Fase Corretta
Fai corrispondere la richiesta dell'utente a una delle cinque fasi: esportazione asset, importazione token, ricostruzione componenti, timeline di motion o gestione shader.
- 03Recuperare via REST o Connector
REST viene usato per asset, token e componenti. Motion e shader richiedono un connector compatibile o un'esportazione manuale.
- 04Congelare gli Artifact Localmente con Provenance
Ogni importazione scrive un file locale, aggiunge al manifest i metadati della fonte e rigenera l'inventario condiviso di utilizzo dei media.
- 05Ricostruire Motion e Storyboard dai Dati di Stato
I frame dello storyboard diventano timeline di elementi tramite il confronto (diff) tra frame adiacenti. Il contesto di motion viene normalizzato in MotionDocs, poi in script GSAP.
- 06Verificare Rispetto alla Ground Truth
Confronta il render con l'esportazione pixel nativa di Figma per la fedeltà statica. La ricostruzione del motion deve superare un motion-PSNR minimo di 15dB.