video-interaction-mapper-figma-mcp-server-guide

1. 基本信息

项目	内容
名称	video-interaction-mapper-figma-mcp-server-guide
项目自述名称	`video-interaction-mapper`（SKILL.md `name` 字段原值）
作者/维护者	Figma 官方团队（提交与合并账号均为 Figma 员工账号：`ilin-figma` 提交、`amuttur-figma` 合并）
来源链接	https://github.com/figma/mcp-server-guide/tree/main/workflow-skills/video-interaction-mapper
许可证	该子目录未见独立开源许可证文件；仓库根 README 明确声明使用本仓库全部资源（含本技能）须遵守 Figma Developer Terms，来自 GitHub API + 网页抓取交叉核实
GitHub Stars / Forks	所属仓库 `figma/mcp-server-guide` 1,892 / 173（GitHub API 实测 2026-08-16；仓库是 Figma MCP 使用指南合集，星数不直接归属本技能，独立佐证见第 6 章）
最新版本	无独立版本号；该路径自加入后仅一次提交（2026-07-06），此后未变更
安装方式	将 `workflow-skills/video-interaction-mapper` 文件夹复制进 agent 的 skills 目录，并连接 Figma MCP Server

2. 功能介绍与亮点

video-interaction-mapper 把一段 UI 录屏（.mp4/.mov/.webm/.avi）自动转换成带标注的 Figma 设计稿 storyboard：

本地用 ffmpeg/ffprobe 抽取关键帧、用 Pillow 压缩，识别录屏中的交互前后状态
推断每次状态切换的触发方式（点击、滑动、键盘输入、悬停等），无法判断时诚实标注“触发方式不明”而非瞎猜
通过 Figma MCP 工具（create_new_file、use_figma、upload_assets、get_screenshot）把截图、蓝色交互标记点、可读的原生 Figma 注释一次性写入 Design 文件，坐标数值只用于标记定位、不出现在给人看的文字里
内置断点续跑机制——本地帧分析全部完成后才创建 Figma 文件，中途某一步失败可从 run_manifest.json 记录的状态继续，不必推倒重来
托管于 Figma 官方 MCP 指南仓库，2026-07-06 由 Figma 员工提交合并，非第三方逆向工程

3. 适用场景

固定分类：前端与设计。适合需要把已有产品的 UI 录屏快速转成设计文档或交互说明的场景——例如竞品交互分析、用户访谈录屏复盘、把现有产品的某段交互流程“反向”整理进 Figma 作重新设计的参考底稿，或为设计评审会准备带标注的状态图。对不便逐帧手动截图、写文字说明的初中级用户尤其省时间。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——SKILL.md 遵循 Claude Agent Skills 规范；Figma 官方文档提供具体连接命令 claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp（已抓取核实）
Codex：✅ 原生支持——Figma 官方材料确认 Codex 是受支持的 MCP 客户端之一，可通过 Connected Apps 或手动 MCP 配置连接（已核实）
OpenClaw：⚠️ 需适配——OpenClaw 具备通用 MCP 连接能力，但未见官方材料专门确认与 Figma MCP Server 的集成，需用户手动添加 MCP 端点并复制技能文件夹
Hermes Agent：⚠️ 需适配——Hermes Agent 遵循 agentskills.io 便携技能标准且原生支持 MCP servers（mcp_servers: 配置块），但同样未见官方专门确认与 Figma 的集成

5. 推荐理由

把“看别人产品的录屏、手动截图再逐张写交互说明”这件事自动化掉——一次性完成抽帧、状态识别、触发方式推断、标注排版并写入 Figma，还带断点续跑，中途失败不用从头开始。对没有设计背景、但常要为竞品分析或交互复盘整理文档的初中级用户，这类“录屏自动生成设计说明”的能力在同类产品里少见。

6. 评分

维度	分数	说明
受欢迎程度	7	Figma 官方编写并托管于自有仓库；所属仓库 1,892 星未达合集特例的 5 万门槛，也未找到该技能自身独立的第三方报道
可用性	7	SKILL.md 与 README 步骤详尽、含 8 步流程与故障处理；但需本机预装 `ffmpeg`/`ffprobe`/Python/Pillow，且依赖 Figma MCP Server 连接（免费版每月仅 6 次工具调用，实际可用需付费 Dev/Full 席位）——多重环境依赖压低了开箱即用程度
安全性	8	见下方检查清单
综合	7.33	三项均值，超过 7.0 达标线，安全性远超一票否决线

安全检查清单：

Shell/权限范围：5 个附带脚本逐行核实，均以显式参数列表调用 ffmpeg/ffprobe 做本地视频处理，未见 shell=True 或字符串拼接执行风险
联网外发：仅通过 Figma 自身的 MCP 工具（create_new_file/use_figma/upload_assets）与 Figma 服务通信，目标透明
API Key/凭据：不要求额外凭据，复用用户已建立的 Figma MCP 连接
可疑指令：逐行核实 SKILL.md 全文与 5 个脚本，未发现 prompt injection 或隐蔽指令
作者/组织信誉：Figma 官方员工账号提交并合并，信誉可靠
License：未见独立开源许可证文件；仓库根 README 声明本仓库资源（含本技能）受 Figma Developer Terms 约束，条款公开可查
维护时间：该技能路径自 2026-07-06 加入后未再变更，但所属仓库整体持续活跃（最近一次提交 2026-08-14）

7. 跟同类 Skills 相比的优势

产品	定位	核心差异
video-interaction-mapper（本推荐）	录屏 → 带标注 Figma storyboard 的自动化流水线	唯一从“视频输入”直接产出结构化 Figma 设计文件的方案，含触发方式推断与断点续跑
figma-openai-plugins	Figma 官方的设计↔代码双向转换插件包	处理的是“Figma 设计稿”与“代码”之间的互转，不接受视频输入，与本技能是互补而非替代关系
Loom	录屏 + 时间戳批注协作工具	停留在视频本身加批注，不产出结构化设计文件，也不识别交互状态或推断触发方式
人工截图整理	设计师/PM 手动截图 + 手写说明	无自动化，逐帧靠人眼判断状态切换与触发方式，耗时且容易遗漏

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

本技能与 figma/mcp-server-guide 仓库内其余 12 个核心 skills/ 目录技能（figma-use、figma-design-to-code 等）不同——README 明确将其归类为“独立于 Figma 插件捆绑包之外的 standalone workflow skill”，需单独复制安装，不会随 Figma 官方插件市场的一键安装自动获得。

10. 安装使用方式

从 https://github.com/figma/mcp-server-guide/tree/main/workflow-skills/video-interaction-mapper 下载 SKILL.md、README.md、scripts/ 整个文件夹，放入所用 agent 的 skills 目录
确认本机已安装 ffmpeg、ffprobe、Python 3，并执行 pip install Pillow 补齐依赖
按第 4 章方式为所用 agent 连接 Figma MCP Server（Claude Code 可用 claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp，其余 agent 参考各自 MCP 配置方式）
触发方式：向 agent 提供本地视频文件路径并说明意图，例如“Use video-interaction-mapper on /path/to/recording.mp4 and create a new Figma file”
安装与连接完成后无需重启，按提示提供视频路径即可直接使用

11. 注意事项

依赖本机具备 ffmpeg/ffprobe/Python/Pillow 环境，纯云端或受限 shell 权限的 agent 环境可能无法运行
Figma MCP Server 免费版每月仅 6 次工具调用，重度使用需付费 Dev 或 Full 席位
许可证依据 Figma Developer Terms（专有条款），非标准开源协议，商用前建议自行确认条款细节
该路径自 2026-07-06 加入后未见后续功能更新，长视频/大量交互场景下的稳定性缺乏独立验证