mcpField
S
sprite-pipeline

sprite-pipeline

github.com/openai创意与媒体7.6k56 次安装3 周前更新
代码仓库

关于 sprite-pipeline

这项技能用于游戏资源流程中的 2D 精灵生成与标准化。它以已批准的种子帧为起点生成完整动画条，再统一帧尺寸并预览结果。

主要功能

  1. 01从种子帧构建参考画布
  2. 02一次生成完整动画条
  3. 03将帧标准化为统一尺寸
  4. 04使用共同锚点对齐各帧
  5. 05渲染预览图进行检查

适用场景

  1. 01制作风格一致的角色动画
  2. 02将生成的精灵整理为游戏帧
  3. 03导入游戏引擎前检查动画条

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openai/plugins --skill sprite-pipeline

安装后在 Claude Code 中输入/sprite-pipeline确认已加载。

附带文件agents/openai.yaml

详细介绍

Sprite Pipeline

概述

使用此技能生成和规范化 2D 精灵图。此工作流特意以一个已批准的帧为基础，并一次性生成整条动画条，因为逐帧生成很容易出现偏差。

此技能仅适用于 2D。如果请求涉及 3D 角色、网格或材质，请转到 ../game-studio/SKILL.md。

核心工作流

  1. 从一个已批准的游戏内种子帧开始。
    • 种子帧应已体现正确的轮廓、调色板、服装和比例。
  2. 在该帧周围构建更大的透明参考画布。
    • 使用 ../../scripts/build_sprite_edit_canvas.py。
  3. 在一次编辑请求中生成完整动画条。
    • 除非用户明确接受较低的一致性，否则不要单独生成每一帧。
  4. 将结果规范化为固定尺寸的游戏帧。
    • 使用 ../../scripts/normalize_sprite_strip.py。
    • 整条动画条使用统一缩放比例。
    • 使用统一锚点对齐各帧，通常为底部居中。
  5. 可选：将第 01 帧锁定回已发布的种子帧。
    • 当动画需要从游戏中已有的精确待机姿势或基础姿势开始时，执行此操作。
  6. 渲染预览图集，并在游戏引擎中检查动画，然后再批准。
    • 使用 ../../scripts/render_sprite_preview_sheet.py。

提示词规则

提示词中始终保留以下不变项：

  • 同一角色
  • 同一朝向
  • 同一调色板系列
  • 同一轮廓系列
  • 同一清晰可辨的面部或关键特征
  • 同一服装比例
  • 透明背景
  • 确切的帧数和格位布局

始终要求：

  • 一次生成一条动画条
  • 使用透明画布
  • 不要场景、标签或海报式构图
  • 像素画需采用清晰的像素簇
  • 呈现可用于生产的素材风格，而非概念艺术

使用图像生成

进行实时素材生成或编辑时，请使用此工作区中已安装的 imagegen 技能。此技能定义游戏专用流程；imagegen 负责通过 API 执行生成或编辑。

脚本示例

创建参考画布：

python3 scripts/build_sprite_edit_canvas.py \
  --seed output/sprites/idle-01.png \
  --out output/sprites/hurt-edit-canvas.png \
  --frames 4 \
  --slot-size 256 \
  --canvas-size 1024

规范化原始动画条：

python3 scripts/normalize_sprite_strip.py \
  --input output/sprites/hurt-raw.png \
  --out-dir output/sprites/hurt \
  --frames 4 \
  --frame-size 64 \
  --anchor output/sprites/idle-01.png \
  --lock-frame1

渲染预览图集：

python3 scripts/render_sprite_preview_sheet.py \
  --frames-dir output/sprites/hurt \
  --out output/sprites/hurt-preview.png \
  --columns 4

质量检查

  • 各帧比例保持稳定
  • 帧间尺寸不发生偏移
  • 动作在游戏尺寸下清晰易读
  • 保留透明度
  • 启用锁定回退时，第 01 帧与已发布的精灵图一致
  • 更新任何游戏引擎内的素材索引之前，确认预览效果正确

参考资料

  • 详细工作流：../../references/sprite-pipeline.md
  • 共享前端上下文：../game-ui-frontend/SKILL.md

评论

支持 Markdown