用途:在 UI 或文案相关 PR 进入 ready-for-review、merge 或生产部署前,做 Figma 与本地代码的对齐检查与视觉发布门禁。动到 visual token、文案、icon、spacing 或 layout 的 PR;ticket/PR 描述带 Figma 链接;代码出现 placeholder、temp、follow-up、沿用某实现等免责语;以及提交前的最后检查,均适用。纯后端或纯逻辑、零视觉文案改动的 PR,以及设计系统明确允许工程自行调整的范围,可不用。
主要能力与用法:先从 ticket、PR 或 Slack 线程取得 Figma node-id,没有 node-id 不得改动 UI 或文案。用 Figma MCP 并行调用以下工具获取规格:mcp__figma__get_design_context、mcp__figma__get_variable_defs、mcp__figma__get_screenshot、mcp__figma__get_metadata;未授权时先跑 mcp__figma__authenticate 或由用户完成 OAuth。Figma MCP 不可用时,回退到 Playwright MCP headed 模式并依赖已登录的 Figma 会话,页面宽度至少 1600×1000,截图 fullPage:true;不可用 WebFetch,因 figma.com 在 webfetch-blocklist 中。随后列出 Figma 到代码的对应表逐项核对,任何不一致都必须处理。视觉门禁通过把 Figma 与本地两张截图放入对话,再执行 /goal 启动,由内置小快模型评估者做纯视觉比对,未通过会给出原因并自动进入下一轮修正,限制为最多 5 轮。通过后再对 git diff 做最后的字面值核对,才能进入发布。另提供审计 grep 配方查找 placeholder、TODO、待 designer、follow-up 等可疑标记。
适用场景:面向改动视觉 token、文案、图标、间距或布局的前端 PR。
限制:必须持有 Figma node-id 才可继续;Figma MCP 需要授权;回退方案依赖 headed 浏览器与已登录会话;视觉评估者不能调用工具,只能读取对话中已有内容;token 名称一致不代表视觉一致,字体回退、加载失败与平台渲染差异仍可能造成偏差;禁止在缺少设计规格时自选 token 或自编文案合并到 main 并发布。