Communitygithub.com

像素艺术与 pix DSL 技能

便携式代理技能,用于处理像素艺术概念和 pix DSL 渲染器。

像素艺术与 pix DSL 技能 是什么?

该技能为 AI 代理提供了一个完整的框架,用于创建、验证和导出像素艺术资产,特别支持 `pix` 领域特定语言(DSL)。它强调严格的设计原则,如可读性、原生分辨率工作、硬边和有限调色板,同时强制执行严格的“抗噪”规则,禁止未明确请求的随机装饰元素。工作流程包括澄清需求、规划、生成 `.pix` 文件、通过 `pix check` 验证、以原生和放大比例渲染以进行视觉检查,以及执行强制性的清理检查。该技能涵盖多种资产类型(徽标、角色、场景、动画),并提供用于导出 PNG、动画帧、精灵表和 GIF 的命令。它旨在通过清晰的标准和视觉审查报告防止模糊的、次优的像素艺术输出,确保最终资产是经过精心设计而非偶然生成的。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

使用 pix 创作像素艺术

当用户请求像素艺术、精灵、图标、徽标、游戏素材、动画帧、精灵表、GIF 或 .pix 文件时,请使用此技能。

不可妥协的原则

  • 可读性优先于细节。
  • 以原生分辨率工作;切勿设计高分辨率图像后再在脑海中缩小。
  • 使用硬边缘、整数坐标,并且不要抗锯齿。
  • 使用有限的调色板,明确区分轮廓、阴影、基础色、高光和强调色。
  • 构建有意的颜色簇,而不是散落的像素。
  • 在整个素材和所有动画帧中保持一致的光照方向。
  • 不要仅凭语法验证就声称完成。必须渲染并目视检查结果。

抗噪规则

除非用户明确要求,否则不要添加漂浮的星星、闪光、灰尘、粒子、角落装饰或孤立的装饰性像素。

对于徽标、图标、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、精灵表和元数据。

核心命令

验证和渲染:

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

素材特定标准

徽标和图标

  • 使用一个主导轮廓和强烈的负空间。
  • 默认情况下,零个漂浮组件和零个环境粒子。
  • 除非能帮助在 1x 尺寸下清晰标识,否则避免使用单像素角落装饰。
  • 在透明、浅色和深色背景上进行测试。
  • 确认在原生尺寸和预期的 UI 显示尺寸下均可识别。

角色和物体精灵

  • 黑色填充的轮廓必须保持可识别性。
  • 眼睛、武器、肢体和其他识别特征必须在 1x 尺寸下可读。
  • 避免纹理与焦点特征竞争。
  • 保持接触阴影附着在主体上或与其清晰对齐,除非有意使用分离的阴影。

场景和背景

  • 建立前景、中景和背景的层次结构。
  • 仅当环境粒子有助于营造氛围、深度或运动时才允许使用。
  • 有意使用重复的纹理图案;避免均匀的随机斑点。

动画

  • 使用不同的关键姿态,而不是微小的任意像素变化。
  • 保持各帧之间的调色板、光照和体量一致。
  • 检查循环过渡并单独检查每一帧。
  • 确保装饰性粒子不会在各帧之间意外闪烁。

强制性清理检查清单

在获得所有满意答案之前,不要标记工作完成:

  • 在 1x 尺寸下主题是否可识别?
  • 轮廓本身(不包含内部细节)是否传达了主题?
  • 每个游离的组件是否有明确的目的?
  • 所有单像素标记是否都是功能性的而非填充?
  • 是否省略了未请求的闪光、星星、灰尘和角落装饰?
  • 高光是否分组并与单一光源对齐?
  • 阴影和接触点是否有意为之?
  • 调色板是否有限且基于角色?
  • 素材是否有干净的边距,没有意外裁剪?
  • 是否在 1x 和放大比例下进行了检查?
  • 是否在合适的背景颜色上进行了检查?
  • 在第一次渲染后是否至少完成了一次清理修订?
  • 对于动画,关键姿态是否可读且循环是否干净?
  • 对于精灵表,帧的排序和命名是否清晰?

视觉审查报告

报告完成时,简要说明:

  • 原生画布大小;
  • 生成的导出文件;
  • 执行的视觉检查;
  • 是否仍存在游离组件或微小颜色簇及其原因;
  • 任何有意请求的装饰。

不要将 pix check 描述为视觉验证。它验证的是源文件,而渲染和检查验证的是艺术作品。

参考资料

当需要更深入的指导时,请阅读:

示例素材

相关技能