Communitygithub.com

pixel-art-pix-skill

可攜式代理技能,用於像素藝術概念與 pix DSL 渲染器

pixel-art-pix-skill 是什麼?

此技能為 AI 代理(例如 Claude Code、Cursor、Codex)提供一套完整的像素藝術工作流程,基於 pix DSL 渲染器。它強制執行非協商原則,例如有限調色板、硬邊緣和一致的光照方向,並透過嚴格的審查流程(包括 `pix check` 語法驗證、實際渲染和視覺檢查)來確保藝術品質。該指南包含針對 Logo、角色、場景和動畫的特定資產標準,以及一個強制性的清理清單,以消除不必要的裝飾(如漂浮的星星或粒子),除非使用者明確要求。此技能也提供用於產生 PNG、動畫畫格、GIF 和 Spritesheet 的 CLI 命令,並支援資產審計腳本 `scripts/audit_png.py`,使開發人員能夠將結構化、可重複的像素藝術工作流程整合到他們的 AI 代理提示中。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add luisfer-cli/pixel-art-pix-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

使用 pix 製作像素藝術

當使用者要求像素藝術、精靈圖、圖示、Logo、遊戲素材、動畫影格、Spritesheet、GIF 或 .pix 檔案時,使用此技能。

不可協商原則

  • 優先考慮可讀性而非細節。
  • 以原始解析度工作;切勿設計高解析度藝術品再在腦中縮小。
  • 使用硬邊緣、整數座標,且無反鋸齒。
  • 使用有限的調色板,並明確指定輪廓線、陰影、底色、高光和強調色的角色。
  • 建構有意的色彩叢集,而非散落的像素。
  • 在整個素材和所有動畫影格中保持一致的光照方向。
  • 僅透過語法驗證後不得聲稱完成。必須渲染並以視覺方式檢查結果。

抗噪音規則

除非使用者明確要求,否則不要添加漂浮的星星、閃光、灰塵、粒子、角落裝飾或孤立的裝飾性像素。

對於 Logo、圖示、UI 素材和透明背景的精靈圖:

  • 預設為零個不相連的裝飾性元件;
  • 在主體周圍保持乾淨的安全邊距;
  • 偏好一個緊湊的主要輪廓;
  • 不要將空白畫布空間視為添加裝飾的邀請;
  • 除非要求或對主體來說必要,否則不要添加名為 sparkles、stars、dust、particles 或類似名稱的圖層群組。

每個可見的叢集必須至少服務一個明確的目的:

  1. 輪廓或結構;
  2. 形體、光影或材質;
  3. 一個識別特徵;
  4. 經要求的環境裝飾。

如果無法用一句簡短的話證明一個叢集的正當性,請移除它。單個像素只有在具有功能時才可接受,例如瞳孔、鏡面高光、對角線的末端或必要的面部特徵。

必要工作流程

  1. 釐清需求。 確定畫布大小、主題、素材類型、風格、調色板限制、背景和匯出格式。如果未要求裝飾,則假設無裝飾。
  2. 設定驗收標準。 從特定資產標準中選擇相關規則。
  3. 繪製前先規劃。 定義輪廓、主要形狀、調色板角色、光照方向、焦點和動畫關鍵姿勢。
  4. 建立或編輯 .pix 原始檔。 根據語義功能命名圖層群組。將可選的氛圍與主體分開。
  5. 驗證原始檔。 執行 pix check。
  6. 以原始比例渲染。 原始輸出是權威的視覺檢查。
  7. 渲染放大預覽。 使用最近鄰居整數縮放,通常使用 --scale 8。
  8. 視覺檢查。 當素材可能出現在不同背景上時,請在透明、淺色和深色背景上檢查原始和放大後的渲染結果。
  9. 執行清理步驟。 分類每個不相連的元件和可疑的微小色彩叢集。刪除任何非故意的部分。
  10. 盡可能審計。 在原始 PNG 上執行 scripts/audit_png.py。將警告視為審查提示,而非錯誤的自動證明。
  11. 修改並再次渲染。 在最終確定新藝術品之前,至少完成一次有針對性的清理疊代。
  12. 匯出最終成果。 產生所需的 PNG、動畫影格、GIF、Spritesheet 和中繼資料。

核心命令

驗證與渲染:

pix check asset.pix
pix render asset.pix -o asset-1x.png
pix render asset.pix -o asset-8x.png --scale 8

渲染指定影格:

pix render asset.pix --frame frame-name -o frame-1x.png
pix render asset.pix --frame frame-name -o frame-8x.png --scale 8

從技能儲存庫根目錄審計原始 PNG:

python3 skills/pixel-art-pix/scripts/audit_png.py asset-1x.png

匯出動畫成果:

pix anim asset.pix -a animation-name --out-dir frames/
pix sheet asset.pix -a animation-name -o sheet.png --json sheet.json
pix gif asset.pix -a animation-name -o animation.gif

特定資產標準

Logo 與圖示

  • 使用一個主要的輪廓和強烈的負空間。
  • 預設為零個漂浮元件和零個環境粒子。
  • 避免使用單像素角落裝飾,除非它們能在 1x 比例下釐清標記。
  • 在透明、淺色和深色背景上測試。
  • 確認在原始大小和預期的 UI 顯示大小下均可辨識。

角色與物體精靈圖

  • 黑色填充的輪廓必須保持可辨識。
  • 眼睛、武器、肢體和其他識別特徵必須在 1x 比例下可讀。
  • 避免與焦點特徵競爭的紋理。
  • 除非刻意使用分離的陰影,否則保持接觸陰影附著在主體上或與主體明確對齊。

場景與背景

  • 建立前景、中景和背景的層次。
  • 僅在環境粒子有助於營造場景、深度或動態時才允許使用。
  • 有意識地使用重複紋理模式;避免均勻的隨機點狀分佈。

動畫

  • 使用不同的關鍵姿勢,而非微小的任意像素變化。
  • 保持各影格間的調色板、光照和體積一致。
  • 檢查循環過渡並逐一檢查每個影格。
  • 確保裝飾性粒子不會在影格間意外閃爍。

強制性清理檢查清單

在每個答案都令人滿意之前,不得將工作標記為完成:

  • 主體在 1x 比例下是否可辨識?
  • 輪廓是否能在沒有內部細節的情況下傳達主體?
  • 每個不相連的元件是否有明確的目的?
  • 所有單像素標記是否具有功能性而非填充物?
  • 是否省略了未要求的閃光、星星、灰塵和角落裝飾?
  • 高光是否分組並與一個光源對齊?
  • 陰影和接觸點是否有意為之?
  • 調色板是否有限且基於角色?
  • 素材是否有乾淨的邊距,沒有意外裁切?
  • 是否在 1x 和放大比例下檢查過?
  • 是否在適當的背景顏色上檢查過?
  • 在第一次渲染後是否至少完成了一次清理修改?
  • 對於動畫,關鍵姿勢是否可讀且循環是否乾淨?
  • 對於 Spritesheet,影格是否有序且命名清晰?

視覺審查報告

報告完成時,簡要說明:

  • 原始畫布大小;
  • 產生的匯出檔;
  • 執行的視覺檢查;
  • 是否還有不相連的元件或微小色彩叢集及其原因;
  • 任何有意的裝飾要求。

不要將 pix check 描述為視覺驗證。它驗證原始檔,而渲染和檢查驗證藝術品。

參考資料

當需要更深層的指導時,可以閱讀:

範例素材

相關技能