SuperAPI AI 工具集

figma-apply-effects

设计与创作

查看项目

更新于 10-16 02:28

技能介绍

用途:该技能面向 Figma Effects 操作,替代“Figma 仅支持四种效果类型”的旧规则。当前 Figma Plugin 类型定义已包含 shadow、blur、noise、texture、glass 等效果族,但 MCP/客户端支持可能滞后于类型定义,因此高级效果受运行时限制。

主要能力:提供 apply(向选中节点添加一个或多个效果)、remove(移除全部效果或指定效果族)、style(应用已有 Effect Style)、bind(将支持的效果字段绑定到变量)、audit(检查当前效果与兼容性)、recipe(把 glow、glassmorphism、soft elevation、grit、texture 等视觉语言转换为效果对象)等模式。

使用方式:先确认目标节点、视觉意图、是替换还是追加效果以及隐私范围;在任何 use_figma 调用前先调用 figma:figma-use;先读取选中节点的 effects、fills、style ID、变量绑定和当前不透明度等元数据。若用户要求已有 Effect Style,先搜索并选择该样式再应用。需要原始效果时,参考 references/effect-compatibility.md 选择效果族。BACKGROUND_BLUR 需节点有可见且 alpha 小于 1 的填充,否则模糊不可见。glow 使用 DROP_SHADOW 配方:亮色、offset 为 { x: 0, y: 0 }、较大 radius、低到中等 alpha。变量绑定仅限支持字段:阴影支持 color、radius、spread、offsetX、offsetY;模糊支持 radius;噪点、纹理、玻璃目前在 Figma 插件类型中不支持变量绑定。最后将返回的绑定效果对象写回节点 effects 数组,并读回元数据报告实际效果、绑定、被跳过字段和视觉注意事项。

效果族:运行时暴露标准 Figma 效果时,核心族包括 DROP_SHADOW、INNER_SHADOW、LAYER_BLUR、BACKGROUND_BLUR;扩展族 NOISE、TEXTURE、GLASS 及模糊内的渐进模糊变体,仅在确认运行时/工具兼容后使用。

限制与安全:读回显示 node.effects 或样式 ID 变化前,不得声称效果已应用;除非用户要求替换,不得覆盖已有效果;不得为不支持的扩展效果族声称变量绑定;若 MCP 无法表达高级效果,应报告手动 Figma 步骤或回退到核心效果近似。验证时检查 node.effects、样式 ID 和可用绑定变量,确认 BACKGROUND_BLUR 有半透明填充路径或说明不可见原因,并可用 evals/evals.json 测试 glow 追加、玻璃模糊半径绑定和不支持的扩展效果变量绑定。输出使用 assets/effects-report-template.md;MCP 能力不确定时参考 $CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md。