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. 視圖: 一張圖裡放俯視、側視、正視、背視四個正交視圖,排成一列。
  2. 雕刻: 只有四個視圖都涵蓋到的位置才保留體素。
  3. 切片: 把雕出的體積切成一條扁平切片,地面那層在最前面。
  4. 算繪: 每層旋轉、依俯仰壓扁、抬高 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 參數,視圖內完全被包住的空隙也會被雕實。上面「限制」一節列出了修正方式。

相關指南

來源

2026 年 11 月 21 日查核:danielwh2/sprite-stacking README、SKILL.md、references/engines.md、LICENSE,以及 GitHub 上的儲存庫資訊(建立於 2026 年 11 月 20 日;2026 年 11 月 21 日有 187 顆星)。

用精靈堆疊的小車或道具做了遊戲?投稿到 VibeGamer。