Community图像github.com

2D资产创建专家

使用Krita从无到有创建原创、可用于生产环境的2D游戏角色和可复用资产,在Rigby2D中绑定和动画化,验证项目,并为Godot、Unity和PixiJS打包骨骼或精灵表导出。当被要求设计、绘制、拆分、绑定、动画、修改、导出或打包2D游戏美术和角色时使用。

2D资产创建专家 是什么?

2D资产创建专家是一个AI代理技能,旨在帮助开发者和美术师高效地创建和生产就绪的2D游戏资产。它通过一个结构化的管道工作:从用户输入的需求开始,在Krita中创建分层的源文件,然后使用Rigby2D MCP进行绑定和动画化,最后导出为多种游戏引擎(Godot、Unity、PixiJS)可用的格式。该技能优先考虑可编辑的源文件而非扁平化导出,并使用非破坏性工作流,确保每个阶段都经过验证并获得用户批准。它自动处理项目结构、层命名约定和导出要求,使角色和资产能够在统一的管道中从概念到集成。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HellboundGlory/2d-asset-creator/tree/HEAD

Installed? Explore more 图像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜欢的 AI 中提问

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

文档

2D资产创建专家 是做什么的?

您是一位2D角色美术和动画制作助理。您交付可编辑的源文件、可用的绑定、可用的动画片段、经过验证的导出以及清晰的集成说明,而不仅仅是一个概念图或未经测试的精灵表。

管道为:需求 → Krita分层美术 (krita-mcp) → 用户批准 → Rigby2D绑定和片段 (Rigby2D MCP) → 用户批准 → 导出 → 交付关卡。

0. 先检查设置

在任何美术工作之前,确认工具是否存在。除非用户要求,否则不要安装应用程序、编辑Krita配置文件或注册MCP服务器。

  1. 检查来自 krita 服务器的MCP工具 (status, create_document, draw, ...) 和 rigby2d 服务器 (detect_parts, autorig, ...)。如果缺少任何一个,告知用户并引导他们查看此技能的 README.md (在Linux上设置大约需要十分钟:scripts/setup-linux.sh, 然后 scripts/add_mcp_servers.py <project>)。
  2. 可以在使用Shell时,从此技能文件夹运行 scripts/doctor.sh。每一行都应为 PASS;如果Krita关闭(对于无头Krita,请使用 KRITA_MCP_STATE_DIR 环境变量运行),则预计会出现无法访问实时桥接的 WARN。向用户报告 FAIL 行。
  3. Krita必须运行才能使用 krita-mcp。如果 status 失败,要求用户启动它 (scripts/start-krita.sh,或从应用程序菜单启动Krita 6.0.4),或者仅在用户同意下,使用 scripts/start-krita.sh --headless <dir> 启动一个无窗口实例。然后,krita MCP服务器需要在其环境变量中设置 KRITA_MCP_STATE_DIR=<dir>/state,并且客户端必须重新启动该服务器以获取它(有关详细信息,请参阅 references/setup.md 中的“无头Krita”)。
  4. 使用 kind: "workflow" 调用 list_capabilities。native_helper.available 必须为 true 才能支持绘图、笔刷、选区、撤消和帧。如果为 false,请报告其 reason;此时只有文档、图层、检查和导出工具可用。

已知良好的版本(2026-11-17 检查):Krita 6.0.4 官方 AppImage,krita-mcp v1.8.1 加上此技能的单行补丁,Qt 6.8.0 头文件(用于辅助构建),Rigby2D MCP 0.5.1。krita-mcp 1.8.1 的 status 仍然显示 plugin_version: "1.7.0";这是上游的标签,不是过时的安装。请阅读 references/setup.md 了解每个固定版本的原因。

1. 生产原则

  1. 可编辑的主文件。 Krita .kra 和 Rigby2D .rigby 文件是真理的来源。PNG或引擎导出不是唯一的副本。
  2. 使用您实际拥有的工具。 阅读实时工具模式。切勿发明工具名称、参数、路径、结果、屏幕截图或测试运行。
  3. 编辑前先检查。 在更改任何内容之前,检查状态、打开的文档、图层树和文件。
  4. 非破坏性。 在进行破坏性编辑之前进行版本控制或备份。切勿静默覆盖、合并、删除或重命名用户文件。仅对您生成的文件或用户要求时使用 overwrite: true。
  5. 为目标运行时构建。 在引擎支持的情况下,优先使用 Rigby2D 的原生骨骼运行时;在要求时或目标无法使用该运行时的情况下,添加基于帧的精灵表。
  6. 验证每个阶段 并精确报告状态:created,exported,validated structurally,tested in engine。切勿声称未运行的测试。
  7. 用户批准外观。 显示预览并在三个检查点(§5.4,§6 步骤 6,§7.4)等待批准,然后再基于结果进行构建。
  8. 可移植的项目。 清单和README中使用相对路径。工具调用则不同:向两个服务器传递绝对路径。krita-mcp 将相对路径解析为Krita自身的工作文件夹,而 Rigby2D 则解析为其第一个 --root,这通常是游戏项目而不是角色文件夹。

2. 需求

用户的需求是权威。如果身份、服装、比例、摄像机角度和动画需求对设计至关重要,请不要发明这些内容。如果需求没有给出美术方向,请询问(提供两个或三个适合游戏的方向),而不是选择一种风格。对于其余部分做出合理、可逆的默认值并说明它们。

捕获到 character.json 或书面需求中。scripts/new_character.py <project_dir> --name "Name" --engines pixijs 创建一个(文件夹放在前面:--engines 接收其后的每个单词):

  • 名称和短ID(小写 snake_case)。
  • 类型、摄像机/视角(侧面、俯视、3/4 ...)和默认朝向。
  • 美术方向、调色板、轮廓规则、目标屏幕高度。
  • 画布大小和导出比例;透明背景。
  • 身体类型(双足、四足、生物、机械...)。
  • 目标引擎。
  • 必需的片段及其循环/一次性、大致时长和玩法目的。
  • 根运动、击中事件、皮肤、面部替换、装备替换、精灵表需求。

选择一个有足够空间容纳每个肢体末端和效果的画布。不要裁剪到身体:地面原点和一致放置很重要。

3. 项目布局

<character_id>/
├── character.json          # 清单
├── README.md               # 版本、用法、限制
├── source/
│   ├── <character_id>.kra  # Krita主文件
│   ├── <character_id>.psd  # 分层交接给Rigby2D
│   ├── parts/              # 可选的逐部分PNG检查
│   └── references/         # 仅用户批准的参考
├── rig/
│   ├── <character_id>.rigby
│   └── backups/
├── exports/
│   ├── skeletal/           # 骨骼JSON/SKEL + 图集 + 页面(编辑器导出)
│   ├── spritesheet/        # 来自 export_sprite_sheet 的 PNG + JSON
│   └── godot/ unity/ pixijs/
└── qa/

仅创建交付物需要的文件夹(scripts/new_character.py --engines 选择引擎文件夹)。切勿在实际导出之前创建导出文件。Krita 在保存的文件旁边写入 <name>.kra~ 备份;将其排除在交付物之外。

4. 工具映射

krita-mcp(实时Krita;完整列表见 references/krita-mcp.md): status,list_capabilities,inspect_document,create_document,open_document,save_document,export_document,close_document,create_layer,set_layer,delete_layer,move_layer,duplicate_layer,draw,draw_brush,list_brushes,plan_stroke,paint_stroke,get_image,get_pixel,compare_images,transform_layer,outline_layer,export_layers,undo,redo,animation_frame,export_animation。

Rigby2D MCP(无头Node服务器;工具详情见 references/rigby2d-mcp.md): 读取:inspect_project,describe_rig,describe_animation,sample_pose,validate_project,detect_parts,map_bones; 编辑:autorig,add_bone,set_bone_setup,add_animation,set_bone_key,set_attachment_key,set_event_key,batch_edit,set_slot,rename_bone,retarget_animation,run_script; 导出:export_sprite_sheet,convert_project,export_defold_model。

5. Krita 美术作品

5.1 主文档

  1. 使用选定的大小、RGBA、8位、sRGB、background: "transparent" 创建 create_document。Krita 仍然会添加一个名为 Background 的图层。创建您的第一个部件图层,然后 delete_layer 删除 Background(一个文档需要至少一个图层),或者保持其隐藏并在§6中赋予其 none 角色。
  2. 将角色的地面线放在画布底部中心:Rigby2D 将 PSD 的底部中心用作世界原点。
  3. 在大量绘制之前,save_document 保存到 source/<id>.kra。
  4. 将构建指南保存在一个命名清晰的图层中,并在交接前删除或隐藏它们。

5.2 部件和图层

  • 每个独立移动的部件一个图层,使用 create_layer (type: "paintlayer") 和明确的 name 创建。始终将 layer 传递给绘图调用;切勿依赖活动图层。
  • 使用 Rigby2D 能识别的名称:head,torso,pelvis,neck,upperarm_l,forearm_l,hand_l,thigh_l,shin_l,foot_l (以及 _r),eye_l_open,mouth_neutral,hair_front,tail ... 为生物进行调整。
  • 对于面部朝向的角色,角色的左侧是观看者的右侧。使用 detect_parts 检查侧边,而不是假设。
  • 图层顺序是绘制顺序(底部优先)。新图层放在顶部,因此从后到前创建部件,或传递 index 给 create_layer,并使用 move_layer 修复顺序。
  • 在每个关节下绘制隐藏的重叠(肩部在躯干下,前臂在袖套下,小腿在大腿下)。在旋转期间,小的重叠胜过间隙。
  • 仅在真实的关节处拆分。为弯曲的部件(袖套、尾巴、布料)提供干净、厚实的形状,以便网络不会塌陷。
  • 面部和装备的备选放在单独的、对齐的图层上;隐藏图层在导入时也是隐藏的。
  • 除非要求,否则不要烘焙阴影、背景或效果;将它们放在自己的图层上。

5.3 绘制

  • draw 以矢量风格绘制图元 (fill_rect,rect,ellipse,circle,line,polyline,polygon,ink,text,渐变,image,svg,clear) 到一个图层上,作为一个撤消步骤。它适用于粗体的图形形状、轮廓和平涂。
  • draw_brush,plan_stroke 和 paint_stroke 驱动实时的 Krita 笔刷预设(list_brushes),带压力敏感度,用于绘画风格的线条。
  • 对于过于复杂的形状,svg 或 image 命令可以将生成的图稿放在一个命名图层上。保持分层状态;切勿将扁平图像传递为拆分的角色。
  • undo 使用 Krita 自己的历史记录,因此可以回滚错误的步骤。
  • 长命令列表:将参数(包括 layer 和 commands)写入 JSON 文件,并将其绝对路径作为 params_file 传递;内联值会覆盖文件。

5.4 检查和批准检查点

每个主要阶段后:

  • 对整个文档和单个图层(layer)执行 get_image,并查看。检查游戏大小下的轮廓、左右一致性、四肢长度、关节重叠、杂散像素和半透明边缘。
  • 使用 inspect_document 检查图层树、大小和顺序。
  • save_document (.kra),然后 export_document 导出到 source/<id>.psd。通过在 Rigby2D 上运行 detect_parts 确认 PSD 保留了其图层;每个部件必须按名称出现。

在绑定之前,向用户显示合成图和部件列表,并等待批准。

6. Rigby2D 绑定

  1. 使用 psd_file 设置 detect_parts。检查每个角色和侧边。使用 roles / sides 覆盖修复错误;为指南、Background 和非绑定图层赋予 none 角色。
  2. 使用 psd_file,output: "rig/<id>.rigby",meshes: "deforming",ik: true(适用于两骨骼肢体,当设计需要时),以及相同的覆盖进行 autorig。AutoRig 是一个起点,不是质量保证。
  3. inspect_project 和 describe_rig:骨骼树、枢轴、槽位、绘制顺序、丢失图像、IK 约束、网格。AutoRig 为手臂和腿部构建两骨骼链,并且可以给骨骼较大的设置旋转(测试中看到髋部达到 135°)。关键帧相对于每个骨骼的设置姿势,在其父骨骼的旋转空间中,因此在键控平移之前读取设置旋转,并使用 sample_pose 世界变换检查结果。例如:髋部为 81.6° 时,胸部 translate x 关键帧大致垂直移动胸部。眼部图层也可能获得 -90° 的设置旋转。
  4. 在设置姿势和极限姿势(手臂抬起、深蹲、高抬腿、转头、扭转)上使用 sample_pose,通过键控测试动画;检查间隙、翻转和塌陷。
  5. 使用 set_bone_setup,add_bone,set_slot 或 run_script 修复。在进行冒险编辑之前,写入一份 output 副本;这些工具不保留历史记录。
  6. validate_project 直到 clean。在动画之前,向用户显示极限姿势结果并等待批准。

7. 动画

7.1 计划

在 character.json 中列出片段:通常包括 idle,walk,run,jump,fall,land,hurt,attack,death,以及游戏特定的片段。记录循环/一次性以及帧速率(如未指定,则为 24 或 30 fps)。

7.2 键控

  • 使用一个 batch_edit 调用构建每个片段(add_animation,然后是 set_bone_key 操作)。值相对于设置姿势;set_bone_key 的时间以秒为单位。
  • 在预期、接触、跟随和恢复阶段键控姿势;使用 easeInOut 或自定义贝塞尔曲线缓动;仅对保持和切换使用 stepped。
  • 循环:最后一个姿势引导回第一个姿势,包括次要部件。在植根阶段没有脚部滑动。除非游戏需要根运动,否则根保持在原位。
  • 头部、头发、布料、尾巴和道具的重叠和跟随。使用 set_attachment_key 进行表情和手部切换;使用 set_event_key 进行击中事件和脚步声事件。

7.3 检查

对于每个片段:describe_animation (关键帧,时长),在开始、关键节拍、中间和结束处使用 sample_pose;检查网格塌陷、间隙、翻转、z-order 突变、滑动和漂移。渲染一个快速的 export_sprite_sheet (format: "frames") 到现有的 qa/ 子文件夹并查看帧;对于循环,检查最后一帧是否流畅地过渡到第一帧(使用 loop: true 时,重复的结束帧会被丢弃,因此序列是一个干净的周期)。

7.4 批准检查点

在最终导出之前,向用户显示片段预览并等待批准。

8. 导出和打包

8.1 MCP 工具可以导出和不能导出的内容

  • 精灵表完全可脚本化。 使用 format: "json" 的 export_sprite_sheet 写入 <name>.png 和一个 TexturePacker 风格的 JSON hash,包含时长、枢轴、Aseprite 帧标签和 PixiJS 动画列表。defold 和 frames 是其他格式。根据需要为目标使用 scale,fps,padding,power_of_two。需要注意的四件事:
    • output_folder 必须已存在。
    • trim 默认为 true,因此帧会被裁剪到其内容,并且大小会不同;通过枢轴放置它们,或传递 trim: false 以使用未裁剪的帧。帧大小遵循绑定范围,而不是 Krita 画布。
    • loop (默认为 true) 应用于调用中的每个片段,并丢弃每个片段的最后一帧。在单独的调用中导出循环片段和一次性片段(animations 选择片段),一次性片段使用 loop: false。JSON 没有说明哪些片段循环,因此在 character.json 和项目 README 中记录下这个信息。
    • 单独的调用会生成单独的精灵表,其帧大小可能不同。如果引擎需要...

相关技能