figma-design-system-sync

Figma 设计系统同步

当 Figma 工作涉及可复用的系统契约时，使用此技能：变量、样式、组件、变体、效果、资源、Code Connect 和本地代码令牌。

模式

• audit：将 Figma 系统产物与本地代码规范进行比较。
• sync-plan：规划变量、样式和组件更新。
• token-map：将 Figma 变量映射到本地令牌。
• component-map：将组件和变体映射到代码组件。
• code-connect：通过已安装的 Figma 技能创建或审查 Code Connect 文件。
• governance：提出命名、版本管理和推出规则。

工作流

1. 使用 figma-context-reader 读取 Figma 上下文，除非已有当前上下文简报。
2. 提出同步操作建议前，先检查本地代码令牌和组件。
3. 如果请求涉及 Code Connect，且存在 figma:figma-code-connect，则调用它。
4. 构建差异对比：Figma 源、代码目标、状态、风险和拟议更改。
5. 对于修改操作，将任务交由 figma-canvas-editor 或 figma-apply-effects，并明确指定范围。
6. 在将 JSON/令牌输出作为依据前，先在本地验证。

防护措施

• 未提供迁移映射时，不要重命名或删除变量、组件或样式。
• 未经审查，不要将生成的代码或变量视为事实来源。
• 记录每种产物的权威方向：从 Figma 到代码、从代码到 Figma，或手动协调。
• 确保变量绑定承诺与当前 Figma Plugin API 支持兼容。

安全与隐私

• 将未发布的令牌、库名称、组件清单和源组件代码视为敏感信息。
• 未提供明确的迁移映射和回滚路径时，不要推送变量/组件重命名。
• 未经批准，不要将私有令牌导出文件或组件快照上传到外部服务。

输出格式

使用 assets/design-system-sync-report.md。

资源

• 阅读 $CODEX_SKILLS_DIR/senior-figma-orchestrator/references/figma-mcp-compatibility.md，了解当前能力检查方法。