用途:审查指定的 Figma Code Connect 映射文件,评估其属性映射的准确性与完整性,并生成审计报告。
主要能力:先加载 figma.connect-best-practices 技能获取各类属性映射规则;在仓库中查找与组件同目录(通常为 figma 目录)的 .figma.tsx 文件;分析每个 figma.connect() 调用中 props 的属性映射、variant 覆盖范围及 Figma URL。通过 Figma MCP 的 get_context_for_code_connect 工具(传入 URL 中的 fileKey 与 nodeId)获取组件属性名称、类型、变体选项与后代树,作为审计依据;必要时用 get_design_context(disableCodeConnect: true)查看视觉上下文;对每个 figma.textContent('LayerName') 用 get_metadata 核对该层是否为 text 节点,若为 instance、frame 等则会在运行时静默失败,应标记为错误并建议改用硬编码占位字符串。同时阅读组件 TypeScript 源码,分析 React props 覆盖情况。
报告内容:覆盖数量(X/Y 属性已映射)、应映射但缺失的属性及建议方法、未覆盖的变体组合、类型或方法与实际 Figma 属性不符的映射、不对应任何 Figma 属性的多余映射,以及按优先级排列的改进建议。
常见检查点:figma.string 用于未出现在正式变体名中的 TEXT 属性会在发布时报错;figma.textContent 用于非 text 节点;figma.children 的层名在不同变体间不一致时需拆分 figma.connect 并加 variant 过滤;带 ↳ 前缀的属性应使用 figma.nestedProps 而非 figma.string;布尔属性误用 figma.boolean 而实际是枚举值;中间变量属性并非真实组件 prop;example 函数含函数体通常意味着 props 设计需重构,且 figma.boolean() 返回不透明描述符,不能用于条件逻辑。
限制:资料未提供安装命令、收费、平台支持或具体运行方式;若找不到映射文件则任务结束。