SuperAPI AI 工具集

game-image-generation-rules

设计与创作

查看项目

更新于 10-16 04:06

技能介绍

用途

Game Image Generation Rules 面向游戏开发中的图像与视觉资产生产,目标是把图像生成组织成一条可复现、可检查、可评估的资产生产管线,而不是依赖单次提示词碰运气。它适用于图标、道具、角色、立绘、环境、瓦片、UI、VFX、精灵表与动画等游戏资产类型。

核心循环

技能定义的工作流程为:PLAN(规划)→ GENERATE(生成)→ NORMALIZE/INSPECT(归一化/检查)→ EVALUATE(评估)→ ACCEPT OR EDIT/REGENERATE(接受或编辑/重生成)→ RE-EVALUATE(再评估)→ OUTPUT(输出)。在定义交付契约与评估标准之前不应开始生成,也不应交付未经检查的资产。

主要能力

  1. 规划资产契约:明确游戏内用途与观看距离、资产族(图标、道具、角色、立绘、环境、瓦片、UI、VFX、精灵表、动画等)、SVG 或栅格、画布尺寸、宽高比、色彩空间、alpha 或混合模式要求与引擎限制,以及相机/投影、剪影、姿势、比例、光照、调色板、材质与风格不变量。还涵盖动画时序、循环行为、帧数、轴心、单元格尺寸与表布局。硬性门槛与质量标准的区分也在规划阶段完成。
  2. 按制品类型路由:SVG 走矢量原生标记构建与校验;栅格 PNG 按交付尺寸或更高生成并保留干净剪影;透明或合成 VFX 栅格使用原生 alpha 或可移除遮罩,纯自发光 VFX 在引擎/材质支持时可用黑底加性交付;整屏或 HUD 合成使用专门模式;精灵表或动画帧可从视频生成、参考表或直接生成三条路线中选择。
  3. 从单一语义来源编译提示词:先写一条后端中立的语义提示词作为事实来源,再派生面向指令型图像模型的原生语言提示词、面向 SD/ComfyUI 的 Danbooru 风格正向标签列表,以及仅在对应后端需要时生成独立负向提示词。编辑指令要求先陈述变换,再重复需保留的不变量。
  4. 批量生成:预检可用的生成、编辑、遮罩/修补、参考图、多参考、alpha、种子、批处理、SVG、视频与输出尺寸限制能力。区分“直接资产批处理”(每个输出是不同可用资产,直接写入目标目录并使用确定性最终文件名)与“变体批处理”(多个尝试竞争同一资产位,用短标签区分角色,比较后仅交付被接受的结果)。
  5. 归一化与检查:在美学判断前执行确定性检查,包括文件结构完整、可解码、格式符合契约、尺寸与宽高比精确、透明度/合成路径有效、无裁切像素、边缘光晕、意外边框或多余空白、保留约定安全边距、网格/单元格几何可整除且一致、动画帧画布/轴心/比例/身份/顺序稳定等。可运行 scripts/inspect_image.py 做基础 PNG 元数据及尺寸、颜色类型、alpha、边框、内边距、表网格等检查,运行 scripts/inspect_svg.py 做 SVG 结构、引用、数值几何、路径、变换、兼容性与可访问性检查。
  6. 视觉评估:按规划阶段写下的标准而非即兴口味评估每个生成资产或变体。先应用硬性门槛,再按游戏内目标尺寸与检查缩放查看,对每条规划标准给出可见证据评分,列出缺陷位置与严重程度,尽可能在匿名 ID 下比较竞争变体,并建议接受、编辑、重生成或更换管线。硬性门槛失败时,不接受高平均分。
  7. 有意识地迭代:针对局部缺陷使用编辑/修补,剪影、姿势、投影或构图错误时重生成,模型反复误读任务时修订提示词编译,当前后端缺少所需能力时更换后端或制品路径。每次编辑输出都要重新评估。
  8. 打包游戏就绪输出:交付被接受的文件与生产元数据,包括确定性文件名与版本后缀、正式矢量资产的源 SVG 加批准预览或图集、正确颜色/alpha 模式的 PNG 或记录在案的加性混合契约、动画时的独立帧加打包表与帧映射、轴心/原点、单元格尺寸、内边距/外扩、帧时长与循环模式,以及批处理/动画的接触表或预览。还需报告假设、所选变体、评估结果、后处理与引擎导入注意事项。

使用方式

该技能通过核心循环运行,并依赖一组配套参考文档与脚本:references/backend-routing.md 用于能力发现与后端选择;references/prompting.md 用于语义提示词、原生提示词、Danbooru 标签编译与编辑提示词;references/game-asset-patterns.md 提供单个资产、角色表、静态精灵集合、环境、瓦片与全景的可复用模式;references/game-hud-patterns.md 提供整屏玩法与 HUD 合成契约;references/game-gallery-patterns.md 提供多面板世界观、混合设计板与角色名册模式;references/evaluation.md 提供硬性门槛、加权评分表、比较与迭代决策;references/raster-and-alpha.md 提供 PNG、alpha、遮罩移除、加性 VFX、边缘清理与交付检查;references/svg-workflow.md 提供通用代码/文本形状检查与生产渲染/视图验证;references/sprite-sheet/sprite-sheets.md 提供精灵工作流路由、共享结果契约、脚本用法、评估、打包及视频、参考、直接与动画预设指引。脚本方面,scripts/inspect_image.py 检查 PNG 元数据与可选尺寸、颜色类型、alpha、边框、内边距与网格;scripts/inspect_svg.py 检查 SVG 结构、引用、数值几何、路径、变换、兼容性与可访问性、scripts/sprite/normalize_pixel_sequence.py 归一化透明视频派生的像素艺术帧,使用共享裁剪、固定原生画布与锚点、序列级调色板、二值 alpha 并生成 JSON 报告(需要 Pillow);scripts/sprite/inspect_sequence.py 测量客观序列漂移与帧几何(运行时需要 Pillow);scripts/sprite/slice_strip.py 将条带切片为帧,或将多行表切为逐行条带再切为帧(--rows),可按 center/centroid/baseline 对齐(运行时需要 Pillow);scripts/sprite/pack_animation.py 将帧打包为一个 PNG 图集加 Aseprite JSON,并自动将动画行分组为逐行图集带、frameTags 与逐行 GIF/APNG(运行时需要 Pillow)。

适用场景

适用于需要以可检查、可评估方式生产游戏视觉资产的任务,包括单个游戏资产、角色表、静态精灵集合、环境、瓦片、全景、整屏玩法与 HUD 合成、多面板世界观板、混合设计板、角色名册、精灵表与动画帧等。

限制

资料未提供具体支持的图像生成后端名称、价格、平台、运行环境或性能指标;仅说明脚本在运行时可能需要 Pillow。部分能力(如生成、编辑、遮罩/修补、参考图、多参考、alpha、种子、批处理、SVG、视频与输出尺寸限制)需在实际可用时预检,技能本身不承诺这些能力必然存在。视觉评估结果不代表目标运行时行为,脚本输出仅为客观证据,不构成视觉质量或语义正确性的证明。