kubai-icons
生成一套风格统一的功能图标,可以交付悬停时会形变的动态版(SVG + JS),也可以导出静态 SVG 文件,沿用 Lumno 书签文件夹图标的构造:后片、内容、前片分层,外描边,所有颜色从一个主色推导,两组关键帧的悬停动效,可切换色板。用户要做图标、功能图标、动态图标、静态 SVG 图标、icon set、带 hover 动效的图标,或要往这套图标里加新图标时使用。
SKILL.mdSKILL.md
GitHubKubai Icons
这个 skill 自带完整的实现:引擎、一整套范例图标、展示页、自检脚本和静态导出脚本。你的工作是按规则写新图标,不是重写引擎。
包里有什么
PROMPT.md:全部设计规则,每一条都是硬性要求。动手前完整读一遍。src/engine.js:引擎。颜色推导、外描边遮罩、厚度带渐变、投影和内发光滤镜、插值动画、色板都在这里。直接复用,不要改。src/icons.js:范例图标。新图标按同样的格式追加。src/app.js、index.html:展示页。ORDER决定展示哪些图标、按什么顺序排。scripts/check.mjs:自检脚本。在无头 Chrome 里截出静止、悬停、悬停过程的中间帧、24px、28px 和所有色板,并读出每一页的脚本报错。临时文件都放在输出目录里,跑完自动清理。scripts/export.mjs:静态导出。把图标渲染成不依赖脚本和样式表的独立 SVG 文件,可以指定色板、主色和静止或悬停状态。
流程
读
PROMPT.md。确定交付形式。用户没说清楚时先问一句:
- 动态(默认):SVG + JS,悬停时形变,靠
src/engine.js在页面里运行。适合网页和能跑 JS 的界面。 - 静态:独立的
.svg文件,没有动效,任何地方都能用:设计工具、原生 App、文档、<img>。用户提到"切图""SVG 文件""放进 Figma""App 里用"等,就是要静态。 - 两者都要:按动态做,最后再导出一份静态。
- 动态(默认):SVG + JS,悬停时形变,靠
确定在哪里做:
- 新做一套:把本 skill 的
index.html、src/、scripts/复制到目标位置(一个新目录或新仓库),在那份副本里工作。保留每个文件开头的版权声明;PROMPT.md和SKILL.md只留在 skill 里,不要复制进去(见LICENSE第 3 条)。 - 往已有的一套里加:直接在那份
src/icons.js里追加。 - 往 kubai-icons 仓库的开源图标库里加:每个图标在
icons/下单独一个文件,格式、命名和角标见docs/authoring.md,自检用node tools/check.mjs --only 名字 --with folder,mail,download。规则仍以PROMPT.md为准。 - 只要静态:同样复制一份到工作目录里画,最后只把导出的 SVG 交给用户。
- 新做一套:把本 skill 的
读产品代码,列出功能。动态版每个功能写一句"物体 + 悬停动作";静态版只需要确定物体(
PROMPT.md第 1 节)。每写一个图标之前,先在
src/icons.js里找一两个结构最接近的范例读一遍(例如翻开的东西看信封和日历,切出前片的看下载和上传,会旋转的看齿轮和星标),照它们的写法来。把名字加进
src/app.js的ORDER。用不到的范例,不放进ORDER就不会显示。运行自检,把新图标和几个现有图标放在一起看:
node scripts/check.mjs --only 新图标A,新图标B --with 文件夹,邮件,下载截图在
check-out/。逐条对照PROMPT.md第 10 节的清单检查;脚本报出错误时先修错误。往复类动作看frames.png;查细缝时加--scale 3;查浅主色上的标记时加--accent #F59E0B,把所有图标换成同一个主色。不加--only就检查整套。静态版看rest.png、size-24.png、size-28.png和palettes.png就够了。改到全部通过后,更新 README 里提到的图标数量,以及展示页每个断点的列数(列数要能整除图标总数,断点可以增删)。
要静态时,导出到用户指定的目录,并告诉用户用的是哪个色板:
node scripts/export.mjs --only 新图标A,新图标B --palette 彩色 --out 目标目录--palette按名字选色板(彩色、蓝灰、青瓷、薄荷、薰衣草、杏色、黑色),--accent #hex把所有图标换成一个主色,--state hover导出悬停结束时的样子,--size设定像素尺寸,--pad给投影留出边距。每个图标一个名字.svg。
环境
- Node 18 以上,以及 Chrome。浏览器路径可以用环境变量
CHROME覆盖。 - 所有检查都在无头模式下进行,不会打开任何可见窗口,也不会动用户正在用的浏览器。
Copyright (c) 2026 Kubai087. Licensed under the Kubai Icons License; see LICENSE.