返回 Skills

神画组件命名

@pws/figma-fundesign-naming

—规则评分检测中

发送 Figma 设计链接后自动命名神画组件的图片与色值并生成逐条带切图的表格;支持查重和按要求跨画板同步,保护源组件和废案。

设计Figma组件命名色值命名设计规范

中文概述 · 根据原始文档整理,完整规则与命令请查看「文件」中的 SKILL.md。

神画组件命名

解决什么问题

将 Figma 活动资源整理为一致的 fundesign 图片和色值名称,减少重复命名和跨画板名称不一致,同时保护源组件与废案。

神画组件案例总览:图片素材、任务图标、框架及色值方块

上图为用户提供的实际案例,展示本技能可整理的图片与色值资源。安装包还声明了三张案例展示图:素材总览、复制页面链接、新增任务按钮;对应图片随包携带。

适用与不适用场景

适用于神画组件的首次命名、增量命名、颜色用途命名、查重、同源实例同步及命名表导出。不用于重绘设计、修改源组件、改色、拆分实例或处理无关活动页面。

需要准备什么输入

提供带节点的 Figma 链接、目标范围及本次操作。需要可读取和修改目标实例的 Figma MCP 连接,以及当前环境的 figma-use 技能;导出 xlsx 另需 Spreadsheets 技能。规则随包提供,用户的新规则优先。权限不足时报告具体限制,不猜测画布内容。

三分钟快速开始

首次使用或需要可复制指令时,阅读 ,覆盖首次命名、增量素材、色值、跨画板同步、查重和表格导出。 直接发送 Figma 设计链接即可:自动命名神画组件、检查重复,并生成每条名称右侧均嵌入对应切图的表格。需要调整时附上要求,例如“只处理新增任务图标,不生成表格”或“同时同步其他画板的同源实例”。“源组件”和“废案”始终只读。

完整操作步骤

按下面流程执行本次授权的操作。参考资料按需读取,真实画布状态优先于历史记录。

默认触发:用户发送 Figma 设计链接,即自动读取链接所在页的「神画组件」,完成图片素材和色值方块命名、检查重名,然后生成每条资源均带对应切图的 xlsx 表格。无需再询问“要不要命名”或“要不要生成表格”。用户有额外要求时优先按要求调整范围和输出,例如只查重、只导表、只处理新增素材、不改名或不生成表格。

默认流程:读取链接与保护区 → 识别神画组件及资源用途 → 保留正确已有名称、命名未命名或明确错误/冲突条目 → 回读查重 → 按行导出实际切图 → 嵌入表格 → 验证并交付。跨画板同步仅在用户明确要求时执行;单独发送链接的默认流程只更名神画组件内的资源。

范围与工具

  • 读取用户提供或会话已明确的 Figma 设计链接,解析 fileKey、nodeId 并确认页面和容器。节点链接默认只覆盖该节点所在页,不扩展到其他活动页面。链接没有节点信息时先读取页面目录并定位唯一的神画组件所在页;若存在多个候选或没有神画组件,仅询问缺失的目标信息,不询问默认操作是否执行。
  • 使用可用的 Figma MCP;调用 use_figma 前加载 figma:figma-use 技能,遵循其 API、批量大小和错误恢复要求,并传入 skillNames: "figma-use"。不复制 Plugin API 文档。
  • 硬性保护:「源组件」和「废案」两个画板/分区及其所有后代均不可修改任何内容。 包括名称、文字、颜色、样式、位置、尺寸、结构、组件定义、变体、关联、导出设置及增删节点。可只读查询以识别匹配关系;不可直接修改,也不可通过修改共享定义等操作间接影响它们。名称包含「废案」的其他分区也排除,遵守用户其他排除范围。
  • “同步全部画板”不包含上述保护区。计划生成、每批写入前的祖先链检查、断点恢复和最终验证均执行该限制;不能采用“先修改、后恢复”作为操作策略。
  • 默认命名阶段可修改神画组件资源名称;显式跨画板同步阶段神画组件只读。只改名称,保持结构、位置、尺寸、视觉内容、实例关联和导出设置。
  • 单独发送 Figma 设计链接按本技能默认流程执行自动命名与表格生成,不追加例行确认。用户明确要求命名、同步或其他限定操作时按其范围执行。无法定位目标、访问失败或用途存在歧义时只澄清必要信息,继续不依赖该信息的工作。

命名依据

图片格式为 fundesign_模块名称_组件名称_img;色值格式为 fundesign_模块名称_色值名称_color。默认链接流程同时处理图片和色值;用户明确限定图片或色值时只处理指定类型。

  1. 用户最新指示优先。跨画板同步以基准容器当前名称为准,不顺便修正基准名称。
  2. 新命名读取 ,依据功能和视觉语义采用既有映射,不仅凭旧中文名称猜测。
  3. 未覆盖素材用简短英文语义补充,沿用 blockBg、titleBg、iconclock 等大小写与组合方式。模块采用 modal、loading、reward、rank、normalblock、rules、mission、monster。
  4. 同类型不同状态在 _img 前的组件词后追加 1、2、3。先确认颜色、状态、用途;已有编号不重排,新系列不能占用已有名称。形状或用途不同的系列另取组件词。
  5. 跳过错误示例 fundesign_modal_button+go_img、fundesign_reward_textname+color,不参考、不擅自修正。
  6. 本会话补充示例:modal_buttonaction1/2 为蓝/金操作按钮;modal_buttonsecondary1/2 为亮/暗次级按钮;mission_buttonstate1/2/3 为灰/黄/绿按钮。红点使用 fundesign_modal_iconreddot_img。跨项目仍先读当前映射,不能把案例当通用强制规则。
  7. 新框架须避开已用和规范中已有用途的编号;例如本项目新增外/内弹窗框采用 modal_blockBg9/10,任务条框采用 mission_blockBg1。不可占用规范中已有含义的 blockBg6/7,也不可因此重排旧素材。

识别与改名

读取基准中的完整素材 id、name、type、源组件 id 和变体信息。完整素材通常是直接子级实例或组件;组件集需检查其具体变体,不给素材内部每个路径和文字都套资源名。

旧名为“按钮”“背景”“Component 28”等时,结合预览及源组件判断。默认流程检查神画组件全部资源,保留正确已有名称,处理未命名、复制后继承错误名称或明确冲突的条目;新增命名请求只处理本次新增或指定条目。不要仅凭 fundesign 前缀判定名称正确,也不要为导出表格重排既有编号。

改名前记录 id、旧名、新名、源组件与画板;校验候选名称在基准中的冲突。逐批写入并回读。保留组件集和变体功能,不拆分实例。

色值方块命名

处理色值前读取 ,按需检索 。颜色按用途命名,不按视觉色相猜用途。

递归检查基准容器内「色值」等分组,识别方块与旁边的说明文字;不要仅扫描直接子级而漏掉色值组。读取文字作为匹配依据,但只更名指定方块,纯文字图层的名称、内容和样式保持不变,分组本身不套资源名。

默认仅修改神画组件的色值方块,不同步其他画板、不改颜色数值、不建立变量或样式;除非用户明确另行要求。改名前记录方块名称、填充、透明度、尺寸位置与文字快照,改后验证只有目标方块名称变化。

跨画板同步

用户明确要求同步时,先读取 。先建立基准源组件及变体到资源名的映射,再遍历授权画板及嵌套组件。优先精确同源同变体匹配,名字相同不能证明素材相同。找不到可靠对应项的保留原名。

查重与验证

  • 查重对象是基准中的完整图片素材、实际变体及命名色值方块,排除组织分组和说明文字;按 img/color 分别统计总数、唯一数、重复项、格式异常。单纯检查不自动授权重命名冲突;用户要求确保唯一时可修复明确冲突。
  • 同一资源跨画板重复使用相同名称是预期行为,不为全页面名字唯一而添加不同编号。
  • 核对实际改名结果及排除区未变;区分已写入、已验证、未完成,不把局部成功说成全量完成。

命名表

生成图文命名表是单独收到 Figma 链接后的默认步骤;用户也可单独要求导出或更新表格。重新读取命名后的 Figma 当前清单,不用过期 JSON 替代实时状态。用户明确要求不生成表格时跳过。

保留四列信息:中文模块|英文模块|中文组件说明|资源名称,名称右侧增加第五列 对应切图。每一条资源数据行都必须嵌入该行名称对应的切图,涵盖图片与色值,不只放第一条或每个模块首条。按模块分组,同组前两列首行填写、后续留空;一个完整素材或色值方块一行,中文说明标明状态,资源名称原样保留。无素材模块不造空行,组织分组和纯文字标注不作为资源行。

逐行保存节点 id、最终名称、用途、资源类型、导出文件和表格行号的对应关系;分组、排序后通过这份映射嵌图,不能只依赖导出数组顺序。切图从该行对应的神画组件节点只读导出,不能用同名的其他素材、整页截图、教程图片或图标示意图替代。图片资源导出完整素材 PNG,保留可用透明背景;色值资源导出该行实际色块,保留实际颜色和透明度。只读取导出,不修改节点或其导出设置,遵守源组件和废案保护规则。

将所有图片嵌入 xlsx 本身,不只放外部路径或临时链接。等比例缩放,按每行切图尺寸设置行高及第五列宽度,保持名称完整、切图清晰、不遮挡相邻行。视觉相近的状态也要使用各自对应的实际节点导出。

若某条切图无法读取或导出,继续完成可以导出的条目,在该行切图位置注明“切图未导出”,并向用户列明资源名称和实际原因。不可换用其他资源、错移图片或删除该行掩盖缺图;保留已命名结果与可用表格,但不能声称全部图文表格已完成。连接或配额完全阻断时保存进度并报告,不反复无效重试。

默认同时纳入实际 _img 和 _color 条目;用户明确只要图片或色值时按指定类型过滤。色值说明取实际用途标注,纯文字说明只用于识别,不改名也不导成资源切图。

中文模块为弹窗框架 modal、加载 loading、奖励 reward、榜单 rank、通用盒子模块 normalblock、规则 rules、任务 mission、怪物 monster。

输出 xlsx 时加载可用的 Spreadsheets 技能并遵循其生成和验证流程。核对资源名集合与实时清单一致,逐行校验名称—节点—切图—表格行的映射、嵌入图片数与成功导出资源数一致。检查全部模块的图文布局、长名称、不同形状素材及色块预览,确认图片已嵌入文件且不越行。交付表格文件和资源数、成功切图数及缺图项,不把工具日志或内部文件路径放入表格。

输出示例和可下载文件

图片名称示例:fundesign_mission_icon1_img;色值名称示例:fundesign_modal_titletext_color。执行后报告实际修改数量、范围、验证结果和未完成项。默认链接流程交付可下载的 xlsx,五列为中文模块、英文模块、中文组件说明、资源名称、对应切图,每一条资源数据行都有实际切图。用户有额外要求时按其要求调整输出。

常见失败及处理方式

链接范围不清先读取定位;同源多名称歧义只处理明确部分并询问;配额或权限阻断时保存已验证进度,后续重读画布再恢复。名称冲突先检查用途和状态,不占用已有语义编号。保护区节点必须从计划中排除,不能先修改再恢复。详细同步边界见 。

作者、协作者和维护人

作者:韦缌钟。维护人:sizhong。协作者:未指定。

版本、更新时间、最后验证时间

版本:1.1.2。本次使用 FunSkill 打包助手 1.7.1 重新打包,新增三张已提供案例图的详情页展示声明。保留发送 Figma 链接后自动命名并导出逐条带切图表格的默认流程,用户额外要求优先。作者为韦缌钟,命名与保护规则不变。更新时间:2026-10-13。最后内容核对时间:2026-10-13。历史会话执行过图片命名、色值命名、局部同步和表格导出;本打包版本未进行独立功能实测,也未做普通提示对照测试。结构校验与压缩包完整性核对不代表 Figma 实操效果或所有客户端兼容性已验证。