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 張必須對齊的小圖。這個技能把這一步省掉了:你(或你的 AI 代理)只要畫四張普通視圖,腳本就會從中雕出所有切片。
這個技能做了什麼
README 把流程分成四步:
- 視圖: 一張圖裡放俯視、側視、正視、背視四個正交視圖,排成一列。
- 雕刻: 只有四個視圖都涵蓋到的位置才保留體素。
- 切片: 把雕出的體積切成一條扁平切片,地面那層在最前面。
- 算繪: 每層旋轉、依俯仰壓扁、抬高 1 px。
技能資料夾裡有:
SKILL.md:給 AI 代理讀的說明。內容包括如何取得合格的四視圖、切片前的檢查清單、切片腳本的參數、算繪迴圈與具體數值、一份「完成標準」清單,以及一張過往錯誤與修正方式的表格。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 參數,視圖內完全被包住的空隙也會被雕實。上面「限制」一節列出了修正方式。
相關指南
- 遊戲開發代理技能與 MCP 伺服器:更多 Godot、Unity、three.js、像素畫和精靈相關的技能。
- Blender MCP:需要真正的 3D 模型而不是精靈堆疊時看這篇。
- Polyfork 免費 3D 模型:給 three.js 遊戲用的免費低多邊形 GLB。
來源
2026 年 11 月 21 日查核:danielwh2/sprite-stacking README、SKILL.md、references/engines.md、LICENSE,以及 GitHub 上的儲存庫資訊(建立於 2026 年 11 月 20 日;2026 年 11 月 21 日有 187 顆星)。
用精靈堆疊的小車或道具做了遊戲?投稿到 VibeGamer。



