Figma 切图命名（sfdesign）

保留技能标识 $fundesign-naming，资源名称使用 sfdesign_。支持自然语言自动调用。

规则来源

执行命名、检查或比对前，完整阅读 references/naming-rules.md 和 references/standard-names.md。后者保存用户确认的 106 个标准名称及用途，可在没有在线表格时使用。

用户当前明确要求优先；用户提供的最新规范表优先于本地标准名称快照。存在对应用途时沿用表内名称，可按规则添加末尾数字；没有对应项时允许自定义，不需要仅因“表内没有”再次请求批准。

仅在创建、更新项目命名文档时阅读 references/document-template.md。

操作范围

• 按用户给出的 Figma 文件和节点定位页面，仅操作明确匹配的【切图组件】画板。没有匹配或有多个候选时，先只读定位，再询问具体目标；不擅自处理相似名称的画板。
• 命名对象是可见、有效的交付资源，包括整体切图、图标及颜色样例。以实际导出单元为准，不能仅凭没有导出设置排除资源。
• 中文说明、分区标题、编号及隐藏备用内容默认保留。文字节点若用于展示交付的字体颜色，则属于资源。
• 优先检查直接子层；必要时深入容器确认独立导出单元，不将整体切图内部每个矢量、文字或装饰层单独重命名。
• 命名任务仅更改资源的 name。不改位置、尺寸、视觉内容、字体、颜色、效果、导出设置、显隐、节点类型、父子关系和子层顺序；不移动、拆分、合并或分离实例，不修改画板外主组件。

按请求选择模式

• 命名／补齐／按规范调整：优先匹配标准，补齐遗漏、处理重复和不符合当前规范的名字。已有正确名称尽量保留；用户要求优先匹配标准或编号分组时，可调整相关旧名。
• 检查／比对：只读报告，不修改 Figma 或文档。
• 生成／更新／同步命名文档：仅在用户授权时执行。仅要求命名或检查 Figma，不自动创建、修改钉钉文档或其他项目文档。

工作流程

1. 读取规则。用户给出规范链接时读取当前命名列和用途，使用 全局命名(sfdesign) 列，不把 原命名 列的旧名称当作标准。读取失败时说明限制，并使用已有规范快照完成可完成的工作；不能声称已验证在线文档。
2. 定位画板并识别资源。利用中文标注、截图及实际页面用途判断模块、状态和类型。其他画板可只读参考，不可修改。
3. 记录节点 ID、名称、类型、父节点、子节点顺序、位置、尺寸及视觉属性基线。大量数据生成排除名称的紧凑校验值，避免返回值截断导致基线不可用。
4. 形成“节点 ID → 旧名 → 新名 → 用途 → 命名来源”的映射，检查语义和唯一性，再小批量仅修改名称。使用 Figma 工具前遵守可用的 figma-use 技能及工具前置要求。
5. 重新读取全部有效资源，检查遗漏、重复和命名来源分类，以及非名称属性是否保持不变。失败时报告实际状态。
6. 简洁报告命名数、唯一名称数、未处理项和保护范围校验结果。比对时分为“完全一致”“标准名称的数字变体”“自定义”，不把后两类混称为完全匹配。

文档比对边界

• 通用规范表不是项目资源清单。表内未被本项目采用的项不是遗漏或多余，不得因此删除。自定义名未被通用表收录也不自动代表错误。
• 项目资源清单才要求与当前有效 Figma 资源逐项对应。只读比对时报告缺失、多余和重复；授权同步后才更新。
• 模块和类型按标准映射及用途确定。sfdesign_color_global_bg 的模块是 global，sfdesign_voice_room_bg 的模块是 voice_room，不能机械取第二段或最后一段。

不确定项

没有标准名称但用途明确：直接自定义并继续。用途、状态或目标本身不明：保留该项，完成其他已确认项，再报告具体问题。不为匹配率把奖牌命名成头像框、把边框图片命名成边框颜色，或把同一级两个标签误当一级和二级。