mcpField
G
game-artist

game-artist

github.com/ikatechis创意与媒体039 次安装43 周前更新
代码仓库

关于 game-artist

这项游戏素材管理技能优先搜索 Kenney 素材库,并按游戏的风格、颜色、尺寸和用途检查现有精灵图。它面向希望先查找、调整和验证素材,再考虑定制美术的游戏开发者。

主要功能

  1. 01搜索 Kenney 素材包和精灵图集
  2. 02评估风格、颜色、尺寸和用途
  3. 03复制、缩放和调整合适的精灵图
  4. 04目视验证素材及游戏内效果
  5. 05批量处理相关素材需求

适用场景

  1. 01查找道具、角色或界面精灵图
  2. 02检查素材是否符合游戏视觉风格
  3. 03准备一组相关游戏素材

安装

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

$npx skills add https://github.com/ikatechis/claude-agentic-mastery --skill game-artist

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

KENNEY_CATALOG.md
STYLE_GUIDE.md
templates/
pollinations_prompts.md

详细介绍

游戏美术技能

采用 Kenney 优先工作流的智能游戏资源管理。

此技能何时触发

在以下情况下,此技能会自动触发:

  • 请求游戏资源(“找一个生命值图标”“需要一个树木精灵图”)
  • 询问视觉元素(“什么适合用作强化道具?”)
  • 想要添加新的精灵图/图形
  • 需要资源推荐

核心原则:仅使用 Kenney

不要生成——使用现有资源!

项目可使用 Kenney 的 All-in-1 合集(约 36,000 个资源,全部采用 CC0 许可):

  • 150 多个 2D 资源包
  • 角色、图块、道具、UI、特效
  • 全部采用统一的扁平/矢量风格
  • 可免费用于任何用途

工作流:

  1. 🔍 搜索 Kenney 合集,全面查找
  2. ✅ 使用匹配度高的现有资源
  3. ❓ 如果找不到,请用户手动查找/生成
  4. ✔️ 确认风格符合扁平/矢量美学

分步工作流

第 1 步:了解需求

需要回答的问题:

  • 资源类型是什么?(角色、物品、道具、UI、特效)
  • 尺寸是多少?(依据游戏世界的比例——参见 STYLE_GUIDE.md)
  • 用途是什么?(可收集物、装饰、功能性)
  • 颜色是什么?(查看 STYLE_GUIDE.md 调色板)
  • 风格要求是什么?(必须符合扁平/矢量风格)

示例:

Request: "Need a health power-up sprite"
→ Type: Item/collectible
→ Size: 48x48 or 64x64 (smaller than character)
→ Purpose: Collectible power-up
→ Colors: Red/green (health colors)
→ Style: Flat/vector, must match player sprite
第 2 步:搜索 Kenney 合集

使用 KENNEY_CATALOG.md 查找相关资源包:

  1. 查看目录 - 浏览资源包索引,寻找可能的候选项
  2. 浏览精灵图表 - 使用 spritesheet*.png 文件查看整体概览
  3. 浏览 Preview.png - 作为替代方式进行视觉检查
  4. 定位资源 - 在 PNG/ 文件夹中查找单个精灵图

视觉浏览策略:

方法 1:精灵图表(推荐)

# Find all spritesheets in a pack
find "/path/to/Kenney/2D assets/[Pack Name]" -name "spritesheet*.png"

# Example for Puzzle Assets:
find "/path/to/Kenney/2D assets/Puzzle Assets" -name "spritesheet*.png"

然后使用 Read 工具进行视觉检查,在一张图片中查看所有精灵图:

Read("/path/to/spritesheet_items.png")
# Claude Vision can see all sprites at once!

方法 2:Preview.png

# Single preview image showing asset samples
ls "/path/to/Kenney/2D assets/[Pack Name]/Preview.png"

方法 3:单个 PNG(需要时)

# Browse individual sprites
ls "/path/to/Kenney/2D assets/[Pack Name]/PNG/"

按资源类型搜索位置:

资源类型主要资源包浏览方式
角色Topdown Shooter浏览 Spritesheet/ 文件夹中的精灵图表
物品/可收集物Generic Items, Puzzle Assets精灵图表或 Preview.png
强化道具Space Shooter Redux, Puzzle Assets查看 spritesheet_items.png
UI 元素Game Icons, UI PackPreview.png(无精灵图表)
道具/环境Topdown Shooter, Generic Items浏览资源包中的精灵图表
特效Explosion Pack, Particle Pack浏览每种特效类型的精灵图表

精灵图表文件命名模式:

spritesheet_complete.png    - All assets in pack
spritesheet_items.png        - Just items
spritesheet_characters.png   - Just characters
spritesheet_tiles.png        - Just tiles
spritesheet_enemies.png      - Just enemies

快速搜索工作流:

# 1. Find relevant pack
ls "/path/to/Kenney/2D assets/" | grep -i "puzzle"

# 2. Check for spritesheets
find "/path/to/Kenney/2D assets/Puzzle Assets" -name "spritesheet*.png"

# 3. Visual inspect with Read tool
Read("/path/to/Kenney/2D assets/Puzzle Assets/Spritesheet/spritesheet_items.png")

# 4. If found what you need, navigate to individual PNG
ls "/path/to/Kenney/2D assets/Puzzle Assets/PNG/"
第 3 步:评估候选项

对每个候选资源:

✅ 风格匹配:

  • 扁平/矢量风格(不是像素艺术)?
  • 圆润流畅的形状?
  • 细的深色轮廓?
  • 简洁的几何形状?

✅ 颜色匹配:

  • 使用游戏调色板?
  • 是否易于重新着色?
  • 是否符合视觉主题?

✅ 尺寸匹配:

  • 是否符合游戏世界的比例?
  • 能否调整为图块的整数倍(64、96、128、192、256)?
  • 调整到目标尺寸后能否保持质量?

✅ 用途匹配:

  • 能否传达预期含义?
  • 轮廓/图标是否清晰?
  • 是否适用于游戏场景?

决策树:

Found perfect match → Use it (Step 4)
Found close match  → Use and modify colors if needed (Step 4)
No good match      → Ask user to provide asset (Step 5)
第 4 步:使用 Kenney 资源

如果找到合适的资源:

  1. 通过检查精灵图表确定准确的精灵图

  2. 定位到单个 PNG:

    ls "/path/to/Kenney/[Pack]/PNG/[Category]/"
    # Find the specific sprite file
    
  3. 将资源从 Kenney 文件夹复制到项目中:

    cp "Kenney/path/to/sprite.png" "assets/sprites/sprite_name.png"
    
  4. 按需调整尺寸(保持宽高比):

    # Use ImageMagick or similar
    magick sprite.png -resize 64x64 output.png
    
  5. 确认透明度 - 检查是否存在 Alpha 通道

  6. 在游戏中测试 - 将其与现有精灵图放在一起

  7. 记录来源 - 注明该资源来自哪个 Kenney 资源包

向用户输出:

✅ Found Kenney asset: [Asset Name]
📁 Source: [Pack Name]
📏 Size: [Original] → [Scaled to]
🎨 Colors: [Matches palette]
💾 Saved to: assets/sprites/[filename]
第 5 步:请用户提供资源

仅在没有合适的 Kenney 资源时:

  1. 报告搜索结果 - 说明搜索了哪些内容,以及没有匹配项的原因

  2. 请用户提供资源:

    向用户输出:

    ❌ No suitable Kenney asset found for: [asset description]
    
    📁 Searched packs:
    - [Pack 1] - [why didn't match]
    - [Pack 2] - [why didn't match]
    
    🎨 Style requirements for manual creation:
    - Flat/vector style (NOT pixel art)
    - Smooth rounded shapes with thin dark outline
    - Simple geometric forms, clear silhouette
    - Transparent background (PNG with alpha)
    - Size: [recommended dimensions]
    - Colors: [recommended from palette]
    
    ✅ Options:
    1. Find similar Kenney asset from different pack
    2. Generate manually with AI tool of your choice
    3. Create/edit sprite with image editor
    4. Use placeholder colored circle for now
    
    📥 Once created, save to: assets/sprites/[filename]
    
  3. 建议占位符 - 提供使用彩色圆形作为后备方案

  4. 等待用户 - 在用户提供资源前不要继续

步骤 6:质量验证

⚠️ 关键要求:始终使用 Read 工具和 Claude Vision 对精灵图进行目视检查!

未经目视确认,切勿假定精灵图符合要求。AI 生成器可能会产生意外结果。

目视验证清单:

  1. 验证实际内容——图像是否呈现了预期内容?(例如:闪电而非五角星)
  2. 与参考图比较——与玩家/僵尸精灵图并排对照
  3. 检查风格——扁平/矢量风格还是像素艺术
  4. 验证透明度——是否包含 Alpha 通道?(查看灰色棋盘格图案)
  5. 检查边缘——边缘是否平滑并经过抗锯齿处理?
  6. 检查颜色——是否在调色板范围内?
  7. 测试可读性——在目标尺寸下是否清晰?

风格一致性清单:

  • 圆润平滑的形状(非像素化)
  • 深色细描边
  • 扁平色彩,带有微妙的渐变
  • 简单的几何形状
  • 透明背景
  • 与玩家/僵尸的风格一致
  • 尺度合适
  • 轮廓清晰

如果发现质量问题:

For Kenney assets:
→ Try different asset from same pack
→ Try similar pack with better style match

For user-provided assets:
→ Give feedback on style mismatch
→ Reference STYLE_GUIDE.md for requirements
→ Suggest specific improvements needed

高级功能

批量请求资源

对于多个相关资源:

  1. 按类型分组——角色、物品、道具等
  2. 检查精灵表——查看整个资源包的概览
  3. 一次性提取全部资源——从同一个资源包批量复制
  4. 保持一致性——同一资源包 = 同一种风格

以下情况改用子 Agent:

  • 通过探索需要 10 个以上资源
  • 创建完整的主题合集
  • 批量生成带有不同变体的资源
  • 复杂的多步骤资源处理流水线
颜色变体

如果 Kenney 资源的颜色不合适:

  1. 使用图像处理工具加载原图
  2. 调整色相至目标颜色
  3. 验证对比度——确保可读性
  4. 使用描述性名称保存变体
# Example: shift green gem to blue
magick green_gem.png -modulate 100,100,180 blue_gem.png
风格迁移(未来功能)

Layer.ai API 可用后:

  • 上传 Kenney 参考图
  • 生成风格匹配的资源
  • 批量处理以保持一致性

模板和资源

快速参考:

  • KENNEY_CATALOG.md——资源包索引和搜索技巧
  • STYLE_GUIDE.md——视觉风格规范
  • EXAMPLES.md——实际工作流示例
  • templates/pollinations_prompts.md——生成模板
  • templates/midjourney_prompts.md——情绪板提示词
  • templates/quality_checklist.md——验证标准

常见场景

场景 1:强化道具精灵图

请求:“需要生命、速度、护盾强化道具的精灵图”

工作流:

  1. 查看 KENNEY_CATALOG.md → “Puzzle Assets 有彩色宝石!”
  2. 查找精灵表:find "Puzzle Assets" -name "spritesheet*.png"
  3. 使用 Read 工具目视检查精灵表 → 一次查看所有宝石
  4. 进入 PNG 文件夹,复制:绿色宝石、蓝色宝石、金色宝石
  5. 将它们全部调整为 64x64
  6. 在游戏中与玩家精灵图一起测试
  7. ✅ 完成——全部来自 Kenney,无需生成
场景 2:自定义敌方角色

请求:“需要一个会飞的僵尸敌人精灵图”

工作流:

  1. 检查 Topdown Shooter 精灵表 → 有僵尸,但没有飞行变体
  2. 检查 Space Shooter Redux 精灵表 → 有飞行敌人,但主题不符
  3. **决定:**未在 Kenney 中找到该资源
  4. 向用户报告:
    ❌ No flying zombie found in Kenney collection
    
    📁 Searched: Topdown Shooter (has zombies), Space Shooter Redux (has flying)
    
    ✅ Options:
    1. Use regular zombie sprite as placeholder
    2. Modify existing zombie sprite with wings manually
    3. Generate externally with: "flying zombie, top-down view, Kenney flat vector style"
    
    📥 Save to: assets/sprites/flying_zombie.png
    
  5. 等待用户提供资源
  6. 收到后,使用 Read 工具进行目视检查
  7. 验证风格是否与现有僵尸一致
场景 3:环境道具

请求:“需要用于环境的树木、灌木和岩石”

工作流:

  1. 查看 Kenney 目录 → 有多个选项
  2. 目视检查 Topdown Shooter/Spritesheet/ 中的精灵表
  3. 检查 Foliage Pack/Spritesheet/ 中的精灵表
  4. 从 PNG 文件夹中提取多个选项
  5. 调整为合适的尺寸(树木 64x128,灌木 64x64)
  6. 在游戏中测试多种组合
  7. ✅ 使用多个 Kenney 资源,轻松获得丰富变化

错误处理

常见问题

找不到合适的 Kenney 资源: → 搜索相关资源包(查看 KENNEY_CATALOG.md) → 尝试使用可修改的相似资源 → 请用户提供自定义资源

用户提供的资源风格不符: → 明确指出问题所在 → 参照 STYLE_GUIDE.md 的要求 → 提供 Kenney 资源示例以供对比 → 建议需要进行的具体风格调整

Kenney 资源尺寸不符: → 调整尺寸并保持宽高比 → 使用 16px 的倍数(64、96、128、192、256) → 调整尺寸后检查质量

颜色与调色板不符: → 调整现有资源的色相 → 在同一资源包中寻找替代资源 → 使用指定的颜色十六进制代码生成

成功秘诀

✅ 始终彻底检查 Kenney —— 90% 的需求都能满足 ✅ 使用 spritesheet 文件 —— 通过目视检查一次查看整个资源包 ✅ 使用 Preview.png 文件 —— 另一种快速浏览方式 ✅ 搜索多个相关资源包 —— 不要只找一个资源包就放弃 ✅ 保持风格一致 —— 全程采用扁平/矢量风格 ✅ 在游戏中验证 —— 与现有精灵一起测试 ✅ 记录来源 —— 追踪资源来自哪个资源包 ✅ 保持宽高比 —— 不要拉伸或压扁 ✅ 使用基于图块的尺寸 —— 以 64px 为基本单位的倍数

❌ 不要混用风格 —— 不要将像素艺术与矢量艺术混用 ❌ 不要过早放弃 —— 先彻底搜索,再询问用户 ❌ 不要忽略比例 —— 尺寸需与角色相称 ❌ 不要忘记透明度 —— 所有精灵都需要 alpha 通道 ❌ 不要使用 tokens 生成 —— 节省 tokens,只使用 Kenney 资源

输出格式

完成资源请求时:

## Asset Request: [Asset Name]

**Source:** [Kenney Pack Name] OR [User Provided]
**File Path:** assets/sprites/[filename]
**Size:** [dimensions] ([X tiles])
**Style Match:** ✅ Verified / ⚠️ Needs review
**Notes:** [Any special considerations]

[Visual preview if using Read tool]

何时建议改用 Subagent

建议在以下情况下使用 subagent:

  • 批量探索:“整理 Kenney 资源包中的所有敌人精灵”
  • 复杂生成:“为新角色创建 8 帧行走动画”
  • 风格重新设计:“将所有 UI 重新设计为赛博朋克主题”
  • 资源流程:“生成 20 种带属性的武器变体”

建议方式:

For this complex task, I recommend using a subagent:
- Run: `Task tool with subagent_type=Explore` for thorough pack search
- OR: Create custom subagent for batch generation workflow
This allows autonomous exploration and decision-making.

请记住

仅使用 Kenney——不要进行耗费 tokens 的生成!

目标是在保持视觉一致性的同时,最大限度地使用专业的 CC0 资源。如果 Kenney 没有所需资源,请用户手动提供,以节省 tokens。

评论

支持 Markdown