该技能用于把用户的 Figma 设计工作带入 HyperFrames 合成工程中，按能力分为以下几个阶段。
用途与总体划分
- 静态资源（Phase 1）：通过 REST 渲染并冻结资产，生成清单与媒体索引。
- 品牌令牌与样式（Phase 2）：导入变量或已发布样式，生成 figma-tokens.json 与绑定记录。
- 组件转 HTML（Phase 3）：将节点树转换为保持 Figma 精确几何的可编辑 HTML，打包为注册表组件。
- 动效转 GSAP（Phase 4）：需要兼容的 Figma 连接器，或将动效上下文归一化为 MotionDocs 后生成 GSAP 时间线。
- 着色器（Phase 5）：连接器渲染路径不执行着色器，默认建议用户在 Figma 中本地导出。 另外支持把 storyboard 区块中的场景帧差分重建为元素动画（而非逐帧播放静图）。
主要能力与命令
- 资源：hyperframes figma asset 'url-or-fileKey:nodeId' [more refs…] [--format svg|png|jpg|pdf] [--scale 2] [--description "..."] [--entity "..."]；支持同一文件多节点单次请求批量渲染，按 fileKey:nodeId:format:scale:version 幂等。
- 令牌：hyperframes figma tokens <fileKey>；把变量导入为合成品牌变量条目、figma-tokens.json 与 .media/figma-bindings.jsonl 绑定记录。非 Enterprise 套餐下退化为已发布样式元数据。
- 组件：hyperframes figma component 'url-or-fileKey:nodeId'；生成 compositions/components/<name>/ 下的可编辑 HTML，填充颜色可绑定为 var(--slug, #literal)。
- 动效：使用连接器一次性递归获取父帧动效上下文，缓存原始 JSON，用 motionContextToDocs 归一化为 MotionDocs，再经 motionToGsap/emitTimelineScript 注入 GSAP 时间线；可用 scripts/verify-motion.mjs 对比动效能量做校验。
- 着色器：默认请用户原生导出 PNG 或 Motion MP4，再作为 Phase-1 资源或片段导入。
- 分镜：按 frame 尺寸筛选场景、按 x 位置排序，相邻帧差分出元素链，导出每个链的资产，用单一主时间线编排；文本注释被解读为过渡意图。
使用方式与认证 首次调用前检查 shell 环境或项目 .env 中是否存在 FIGMA_TOKEN；若没有，引导用户在 figma.com/settings → Security → Personal access tokens 生成只读令牌，所需作用域为 File content: Read-only、File metadata: Read-only，非 Enterprise 套餐运行 tokens 时还需 Library content: Read-only，可选 Variables: Read-only（Enterprise 限定）。令牌应写入 shell profile 或 .env，不要粘贴到对话中。错误码含义：401 令牌过期需重签；403 提示缺失的具体作用域或文件不可见；变量 403 属预期降级；429 客户端自动退避重试。
适用场景与限制 适合将 Figma 图层、品牌规范、组件、动画与分镜重建为可渲染的 HyperFrames 合成。限制包括：动效与着色器依赖兼容连接器或原生导出；着色器无法通过连接器像素捕获；变量能力受 Enterprise 套餐限制；批量图像请求较大时需分块以规避渲染超时；命名缓动不在映射表内会回退为线性；组件导入后需做静态保真自检，文本边界存在已知偏移轴。