用途:当 Figma 工作涉及可复用的系统契约(变量、样式、组件、变体、效果、资源、Code Connect 及本地代码令牌)时使用本技能,用于同步与审计 Figma 与代码之间的设计系统契约。
主要能力(模式):audit 对比 Figma 系统产物与本地代码约定;sync-plan 规划变量/样式/组件更新;token-map 将 Figma 变量映射到本地令牌;component-map 将组件与变体映射到代码组件;code-connect 通过已安装的 Figma 技能创建或审查 Code Connect 文件;governance 提出命名、版本与发布规则。
工作流:先用 figma-context-reader 读取 Figma 上下文(除非已有当前上下文简报);在建议同步动作前检查本地代码令牌/组件;若请求 Code Connect,在存在时调用 figma:figma-code-connect;构建差异表(Figma 来源、代码目标、状态、风险、建议变更);变更操作交由 figma-canvas-editor 或 figma-apply-effects 并明确范围;在将 JSON/令牌输出作为证据前先在本地验证。
限制与护栏:没有迁移映射不得重命名或删除变量/组件/样式;生成代码或生成变量在审查前不得视为事实来源;需记录每个产物的权威方向(Figma 到代码、代码到 Figma 或手动协调);变量绑定承诺需与当前 Figma Plugin API 支持兼容。安全与隐私:未发布的令牌、库名称、组件清单与源组件代码视为敏感;没有明确迁移映射与回滚路径不得推送变量/组件重命名;未经批准不得将私有令牌导出或组件快照上传到外部服务。输出使用 assets/design-system-sync-report.md;能力检查参考 $CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md。