minecraft-imagegen

Minecraft 图像生成技能

当 Minecraft 项目需要新的栅格艺术作品或视觉概念，且之后会进一步完善为资源包、发布帖、商店商品页或服务器品牌素材时，使用此技能。

范围

路由边界

• 使用场景：任务是为 Minecraft 项目生成或编辑位图图像，例如 pack.png、发布艺术图、商店缩略图、概念纹理、UI 模型图或服务器／横幅艺术图。
• 不适用场景：任务是确定性的资源包实现工作，例如 pack.mcmeta、方块／物品模型 JSON、方块状态、字体、声音或着色器文件（minecraft-resource-pack）。
• 不适用场景：任务涉及矢量／代码原生 UI、现有 SVG／logo 系统，或非图像代码／素材。
• 不适用场景：当前宿主未提供内置图像生成工具或等效的图像编辑工具。

参考资料

• 对于需求不明确的请求或生成／编辑提示词模板，请阅读提示词模式。
• 对于资源包图标、发布横幅、服务器页眉或纹理概念图表，请阅读素材配方。
• 仅当保存的需求说明有助于收集利益相关方反馈或进行多轮迭代时，才使用 scripts/scaffold-asset-brief.sh；对于明确的图像请求，可直接开始。
• 从项目工作区使用该助手时，请调用其已安装路径的绝对路径。相对的 --out 值以该工作区为基准解析。从已安装的技能目录运行时，请传入项目路径的绝对 --out，或设置 CODEX_WORKSPACE_ROOT。

---

默认执行

• 如果当前宿主未提供内置图像生成工具或等效的图像编辑工具，请停止并告知用户此宿主无法使用该技能；可提供提示词／需求说明准备服务，或建议使用具备可用图像生成工具的宿主。
• 当宿主支持时，默认使用内置的 image_gen 工具。
• 根据请求的交付内容执行：用户要求完整素材时就完成素材；用户要求探索时则生成概念。对于明确的生成或编辑请求，不要要求用户单独批准概念。
• 内置图像生成工作流支持全新生成，也支持基于现有本地图像／参考图像进行编辑；优先使用该工作流，而不是描述手动覆盖绘制的过程。
• 如果宿主能提供输出文件，请将请求的项目素材保存到预期工作区路径；否则，返回生成的图像并说明无法确认其已保存到本地。
• 通过使用带版本号的文件名，以非破坏性方式保留现有素材；只有用户明确要求覆盖时才覆盖。
• 编辑本地图像时，请先加载或附加该图像，确保 Agent 能看到图像后再请求编辑。

---

适用场景

• 为模组、数据包或资源包制作 pack.png 概念图或替换图
• 用于 GitHub、Modrinth、CurseForge 或社交媒体帖文的发布横幅艺术图
• 纹理视觉开发参考图，之后将由人工整理为最终像素艺术
• 服务器 logo、横幅、启动图或规则界面艺术图
• 用于规划插件或模组 UX 的 HUD／菜单模型图
• 展示方块、生物或主题环境的情境宣传图表

---

工作流

1. 根据请求确定素材类型、目标尺寸、输出路径，以及这是生成还是编辑。编辑时检查现有图像；仅在需要时收集风格参考。
2. 使用可用工具生成所需素材。描述主题、构图、Minecraft 风格和限制条件。编辑时，说明要做的改动以及必须保持不变的内容。
3. 按预期显示尺寸检查结果。针对发现的缺陷进行定向编辑；如果结果符合要求，无须进行额外迭代。
4. 保存或返回所需结果，并确认保存路径。若集成工作在范围内，则完成像素清理、平铺处理和资源包引用。可选用其他技能。

---

素材专属指南

包图标

• 按正方形裁剪和小尺寸清晰可读的要求设计。
• 保持轮廓醒目，文字精简。
• 在 64x64 尺寸下检查可读性；这是实用的预览尺寸，并非 pack.png 的强制分辨率。请使用项目的目标尺寸和宿主支持的图像编辑工作流。

纹理概念

• 要求采用平面正视呈现、光照均匀且透视感极弱的效果。
• 说明纹理应贴近原版风格、带有噪点或粗粝感、手绘，还是风格化。
• 假设发布前需要手动清理。生成的纹理最好用作概念参考或绘制覆盖参考，而不是直接自动投入使用。

UI 模型图

• 为标签、槽位和状态文本留出负空间。
• 文字应大且对比度高。
• 明确说明模型图应采用原版、模组科技、奇幻，还是管理面板风格。

宣传图和缩略图

• 留出适合放置发行标题或标语的负空间。
• 避免使用过小的文字和杂乱元素，以免在手机屏幕或商店卡片上变得模糊。
• 说明输出应呈现类似游戏画面的构图、主视觉艺术，还是简洁的展示布局。

---

审核清单

• 图像在实际目标尺寸下清晰易读。
• 所有文字拼写正确，且位置符合要求。
• 未添加额外的徽标、水印或无关物体。
• 风格符合所要求的 Minecraft 情境。
• 对于纹理概念，效果应便于手动覆盖绘制、简化或平铺。

---