sprite-stacking 是 Daniel White 做的开源智能体技能(agent skill)。你给它一个物体的四张像素画视图(顶视、侧视、正视、背视),它会生成一个“精灵堆叠”(sprite stack):一条由扁平切片组成的图片条,游戏把这些切片一层层叠着画出来,看上去就像一个能转动的 3D 物体。它支持 Claude Code、Codex、Cursor、OpenCode、Gemini CLI 和 Pi。仓库创建于 2026 年 11 月 20 日,我们在 2026 年 11 月 21 日查看时有 187 个星标,许可证是 MIT。

这篇指南讲精灵堆叠是什么、这个技能多做了什么、怎么安装、要给它什么输入,以及它的短板。下面每条命令都照抄自仓库的 README 或 SKILL.md。我们在 2026 年 11 月 21 日读了这些文件,但没有亲自运行这个技能,所以文中描述的输出是文档说应该得到的结果。

什么是精灵堆叠

精灵堆叠就是把一个俯视角的物体从地面往上切成一层层水平切片,像从底部开始切一条面包。游戏从下往上画这些切片,每一层旋转相同的角度,按镜头俯仰角在竖直方向压扁一点,再比下面一层抬高 1 像素。效果像一个能平滑转动的小体素模型,但本质上还是普通的 2D 绘制:不需要 3D 引擎,没有网格,每个角度都是清晰的像素。

README 说得很明白,这不是新技术:“Sprite stacking is a long-standing indie game technique, not invented here.”这个技能新增的是“四视图雕刻”和围绕它的智能体工作流。

精灵堆叠最麻烦的是画切片。一辆 30 层的车就是 30 张必须对齐的小图。这个技能省掉了这一步:你(或者你的智能体)只画四张普通视图,脚本从中雕出所有切片。

这个技能做了什么

README 把流程分成四步:

  1. 视图: 一张图里放顶视、侧视、正视、背视四个正交视图,排成一行。
  2. 雕刻: 只有四个视图都覆盖到的位置才保留体素。
  3. 切片: 把雕出的体积切成一条扁平切片,地面那层在最前。
  4. 渲染: 每层旋转、按俯仰压扁、抬高 1 px。

技能文件夹里有:

  • SKILL.md:智能体读的说明。内容包括怎样得到一张合格的四视图、切片前的检查清单、切片脚本的参数、渲染循环和具体数值、一份“完成标准”清单,以及一张记录过往错误和修法的表。
  • scripts/views_to_slices.py:切片脚本。它去掉背景,去掉每个视图外围 1px 的描边,把颜色统一到一个共享调色板,雕出切片,还可以输出一张检查图和一个独立的查看器网页。
  • scripts/viewer.html:浏览器查看器,也可以单独打开,直接拖入切片条。
  • references/engines.md:简短的接入示例,覆盖网页 Canvas 和 React、Godot 4、Unity,以及 Phaser、Pygame 等其他环境。

在 Claude Code 或 Codex 里安装

README 给的一行安装命令用的是 skills CLI,需要 Node 22.20 或更高版本:

npx skills add danielwh2/sprite-stacking

这会把技能装到当前项目里。按 README 的说法,加 -g 会装给所有项目,加 -a claude-code(或 codex、cursor 等)可以指定装给哪个智能体。

另一种方式是把仓库里的 skills/sprite-stacking 文件夹复制到你的智能体的技能目录:

智能体 目录
Claude Code ~/.claude/skills/
Codex, Cursor, OpenCode, Gemini CLI, Pi ~/.agents/skills/

切片脚本是 Python 写的,所以还需要装了 Pillow 和 NumPy 的 Python 3。README 里的命令:

pip install pillow numpy

怎么用:跟智能体说什么

不需要点名调用这个技能。装好之后,直接说你要什么,智能体会自己用上它。README 里的例子:

  • “Make a rotatable pixel art car.”(做一辆可以旋转的像素画小车。)
  • “Sprite stack this 4-view sheet and give me a turntable.”(把这张四视图做成精灵堆叠,再给我一个转盘预览。)
  • “Add a fake 3D pixel art tree to my Godot game.”(给我的 Godot 游戏加一棵伪 3D 像素画树。)

SKILL.md 让智能体根据你给的东西选路线:

  • 切片条 PNG 或 MagicaVoxel 的分层导出: 直接进入渲染。
  • 四视图: 先检查,再雕刻。
  • 只有一句提示词或一个想法: 先做出四视图,再雕刻和渲染。

如果你没有四视图,智能体手上有图像生成工具时,会用 SKILL.md 里写好的提示词去生成;没有的话,它会用一段简短的 Python 脚本自己把四个视图画成像素画。README 的原话很直接:“No image generator? The agent draws the views itself in a short Python script.”

如果是已有的游戏,SKILL.md 要求智能体先读你的渲染器(引擎、像素缩放、精灵怎么绘制和排序),把堆叠接进去,绝不另开第二个画布或渲染管线。

需要什么输入

四视图有严格的规则,大多数糟糕的结果都是因为没遵守。以下来自 SKILL.md:

  • 排成一行,顺序是 TOP、SIDE、FRONT、BACK,纯白背景,视图之间留出明显空隙。
  • TOP 垂直往下看,物体正面朝下。SIDE 的正面朝左。
  • 严格正交:没有透视,没有倾斜,不要 3/4 视角。
  • 四个视图比例一致:TOP 的长度等于 SIDE 的长度,TOP 的宽度等于 FRONT 和 BACK 的宽度,SIDE 的高度等于 FRONT 和 BACK 的高度。
  • 平涂色块和干净的描边。柔和的喷枪边缘和细细的 1px 内线在切片旋转后会糊掉,技能建议直接重画,别想着补救。

它还给了三档尺寸:

  • 粗颗粒复古: 15 到 20 层,约 25×48 px,以 8 到 10 倍显示。
  • 精细高位像素: 26 到 44 层,36×72 到 46×107 px,足以放下通风口、标志和辐条轮毂。
  • 展示 / 1080p 视频: 36 到 56 层,30×30 到 148×148 px,以 4 到 6 倍显示。

自己运行切片脚本

一般由智能体来跑切片脚本,不过你也可以在仓库根目录用 README 里的命令自己跑:

python3 skills/sprite-stacking/scripts/views_to_slices.py views.png slices.png \
  --slices 36 --preview check.png --html viewer.html

views.png 是你的四视图,slices.png 是脚本输出的切片条。README 列出的参数:

  • --slices N:层数。粗颗粒用 15 到 20,精细用 32 到 48。
  • --order reading:强制按 TOP、SIDE、FRONT、BACK 的顺序识别。默认会根据比例自动匹配视图。
  • --round:把塔、气球、花盆雕成圆的,而不是方的。
  • --side-nose right:SIDE 视图朝右时使用。
  • --colours N:共享调色板的颜色数;0 保留所有颜色。
  • --normals path.png:额外保存一条对应的法线贴图切片条。
  • --emissive path.png:额外保存一张自动检测的发光遮罩(车灯、窗户、霓虹)。

SKILL.md 还列了几个参数,包括 --top-nose(不是车辆的物体传 down)、--shade、--bg-tol 和 --dark-thresh。

check.png 会显示提取出的四个视图、四个转盘角度和一个爆炸视图。技能要求智能体在写任何游戏代码之前先看这张图。

查看器

--html 会输出一个独立网页。按 README 的说法,它有转盘模式、带程序化道具的场景模式、切片扫描、爆炸视图,还有一个可以用 WASD 或方向键开车的游玩模式。另外还有昼夜时间、可拖动带阴影的太阳、雨雪天气,以及一个导出按钮,能烘焙出 16 个方向的 PNG 精灵图。如果你的引擎只认普通的多方向精灵,最后这个功能很实用。

接入游戏

渲染循环在哪儿都一样:从地面那层开始,把每层切片绕中心旋转,y 方向按 squash 值缩放,按层号乘以 spacing 抬高,对齐到整像素,用最近邻过滤绘制。SKILL.md 给的默认值是:spacing 1.0,斜俯视镜头的 squash 为 0.75(1.0 是垂直俯视)。references/engines.md 里有现成的 Canvas 2D 函数和 Godot 4 Node2D 脚本,还有 Unity(每层一个 SpriteRenderer,Point 过滤)和 Phaser、Pygame 的说明。

技能里有两条建议对性能和观感很关键。一是按接地点对整个堆叠排序,绝不把两个物体的切片交错画。二是静态堆叠在游戏加载时就烘焙成普通精灵:技能指出,200 棵树每棵 30 层,一帧就是 6,000 次绘制。

局限

以下来自技能自带的检查清单和过往错误表:

  • 藏起来的空腔会被填实。 雕刻只保留四个轮廓都覆盖的部分,所以哪个视图都看不到的货车车斗或空心拱门会变成实心。侧视图里能透光的悬空部分(比如抬高的尾翼)可以保留。空腔只能在雕刻后手动修。
  • 圆形部件会雕成方的,除非顶视图里画的是像素圆;如果圆形部分比底座窄,还要加 --round。
  • 1px 的部件会闪烁,随着转动时有时无。柱子、绳子、天线至少要 2px 宽;切片脚本会打印警告。
  • 凸出物会变成台阶。 墙上伸出来的东西,比如花箱或招牌,会沿整面墙雕出一条台阶。小的凸出物直接平画。
  • 封闭的空隙会被雕实。 视图内部完全被包住的背景(腿之间、鳍之间、绳子之间)会被当成物体的一部分。每个空隙都必须通到视图外面。
  • 不居中的物体会晃。 堆叠绕包围盒中心旋转,所以物体要在视图里居中。
  • 只适合像素画。 这个技术和切片脚本是为小尺寸、平涂明暗的精灵做的,不能用来给 three.js 或 Unity 3D 游戏做真正的 3D 模型。

许可证

仓库采用 MIT 许可证(版权 2026 Daniel White),GitHub 页面和 LICENSE 文件里都写着。你可以使用、修改,也可以用在商业项目里,只要在代码副本中保留版权和许可声明。README 没有提到用它做出的精灵适用什么许可。

常见问题

什么是精灵堆叠?

一种在 2D 游戏里假装 3D 的方法。物体存成一条俯视的扁平切片,游戏从下往上画,每层旋转同样的角度并抬高 1 像素。看起来像一个会转的小体素模型,但仍然是清晰的像素画。

sprite-stacking 技能免费吗?

免费。它在 MIT 许可证下开源。你只需要带 Pillow 和 NumPy 的 Python 3;如果用 npx skills 安装,还需要 Node 22.20 或更高版本。AI 智能体的订阅或 API 费用另算。

它支持 Claude Code 和 Codex 吗?

支持,README 里两个都列了。用 npx skills add danielwh2/sprite-stacking 安装(加 -a claude-code 或 -a codex 指定智能体),或者把 skills/sprite-stacking 复制到 ~/.claude/skills/(Claude Code)或 ~/.agents/skills/(Codex)。

一定要有图像生成工具吗?

不用。智能体有图像生成工具时,技能会给它一段生成四视图的提示词;没有的话,智能体会用一段简短的 Python 脚本自己画。你也可以直接给它你画好的四视图、一条切片条,或者 MagicaVoxel 的分层导出。

生成的结果能用在 Godot、Unity 或 Phaser 里吗?

能。references/engines.md 里有 Godot 4 脚本、Unity 说明、网页和 React 用的 Canvas 2D 函数,以及适用于 Phaser 和 Pygame 的通用循环。查看器还能导出 16 方向的 PNG 精灵图,给只认普通精灵的引擎用。

为什么我的精灵有些部分变成了实心或方块?

切片脚本只保留四个视图都覆盖到的体素。所有视图都看不到的空腔会被填实,圆形部件需要顶视图里的圆或 --round 参数,视图内部被完全包住的空隙也会被雕实。上面“局限”一节列出了修法。

相关指南

来源

2026 年 11 月 21 日核对:danielwh2/sprite-stacking README、SKILL.md、references/engines.md、LICENSE,以及 GitHub 上的仓库信息(创建于 2026 年 11 月 20 日;2026 年 11 月 21 日有 187 个星标)。

用精灵堆叠的小车或道具做了游戏?提交到 VibeGamer。