用途:把 Figma 设计实现为目标代码库中的代码,即“设计→代码”方向。反向(从代码生成或更新 Figma 设计)应使用 figma-generate-design。
主要能力与用法:调用 get_design_context 前必须先启用本技能,并在其 skillNames 参数中以逗号分隔形式包含 figma-design-to-code;若通过 MCP 资源加载,需加前缀,如 resource:figma-design-to-code。该参数仅用于记录技能使用,不影响执行。参数机制(nodeId、fileKey、branchKey 提取、URL 解析、format/query 选项、响应结构)以 get_design_context 工具说明为准。
工作流:先对目标节点调用 get_design_context,它一次返回参考代码、截图和上下文提示;不要用 get_metadata 或 get_screenshot 替代,它们仅用于定位节点或校验。返回代码为带提示的 React + Tailwind,只能作为参考,必须适配目标项目的语言、框架、组件库、样式系统与约定,并优先复用项目已有组件、布局模式和设计令牌。提示按优先级应用:Code Connect 片段、组件文档链接、设计标注、设计令牌(CSS 变量)、原始十六进制/绝对定位。
图像与图标:图标和图片以 <img> 返回,src 为远程资源 URL(https://.../api/mcp/asset/...)。必须使用导出的资源渲染,不得手写或内联 svg/path,不得自建图标文件、丢弃图标或留占位符。资源 URL 可直接作为 src 即时渲染,但约 7 天后过期;要提交的代码应下载并提交该资源字节,或接入项目数据源。仅当项目图标字形明确匹配时才复用组件。尺寸需显式设置:固定尺寸容器同时设定宽高(图标通常为方形,如 size-[24px]、overflow-clip),叶子 img 填满容器(100% 或固定 px),不可用 auto。
限制与错误处理:本技能不得用于写回 Figma。get_design_context 报错时应停止并阅读信息后再重试;若设计 URL 无 node-id(仅文件 URL),应向用户索取含节点的 URL,不得猜测或传空 nodeId;超时则改用更小节点或选区重试;在 get_design_context 仍能提供上下文时,不得仅凭截图手写界面。