Frame · Figma 设计上下文

要解决什么问题

设计稿在 Figma 里，实现却在 IDE 与 CI 里完成。中间若缺少可机器消费的结构化事实——组件层级、变量绑定、Code Connect 映射、文件版本——下游智能体只能猜布局与令牌，设计-代码漂移会在 30 天以上的旧映射里悄悄累积。

Frame 的定位是提取，不解读：它不写应用代码，只把 Figma 上下文整理成面向具体消费者的交接包，并遵守 MCP 速率预算。

核心能力与工作流

技能按 CONNECT → SURVEY → EXTRACT → PACKAGE → DELIVER 执行，子命令可按场景切换默认配方：

• extract：用 get_design_context 作为主结构来源，必要时用截图补充；大文件先 get_metadata 再按页面/节点增量拉取。
• tokens：优先 Figma Variables，输出可对齐 W3C DTCG 2025.10（含主题、$extends、Display P3 / Oklch）。
• code-connect：审计、修复或同步映射；超过 30 天的映射应标记为过时。
• variants / breakpoint / rules / inspect：变体矩阵、响应式断点、设计系统约定与程序化检查。

写回画布走 use_figma（代码渲染 UI → 可编辑 Frame），属于显式用户确认的写入路径；调用时需传 skillNames: ["figma-use"]，小步增量、全量 await 异步 API，并返回 createdNodeIds / mutatedNodeIds。

与生态的衔接：Forge（原型）、Artisan（生产组件）、Builder（后端 schema）、Muse（令牌定义）、Vision（创意方向）、Vitrine（双向 Code Connect 与视觉回归）等，Frame 只负责打包事实并推荐下一个智能体。

边界与注意点

• 任何提取前先 whoami 验证 MCP；远程 MCP 覆盖最全。保留约 10% 速率缓冲，预算见底应优雅停止。
• 每次交付应含源 URL、文件版本、时间戳、范围描述、速率消耗/剩余；不完整提取必须明确标注，禁止冒充完整包。
• 绝不在无明确请求时改 Figma；绝不用原始色值替代已绑定的 Variable；绝不在 use_figma 里使用 ALL_SCOPES 或遗漏 await。
• 实现 UI：用 Forge / Artisan；纯 UX 策略无 Figma 提取：Vision；端到端含设计系统持久化：Atelier。