用途
SpriteCook Use Presets 用于通过 MCP 使用 SpriteCook 中已保存的预设。预设是保存下来的 SpriteCook 设置与提示词配方,其目的是帮助用户之后获得一致、相似的输出,尤其是在需要一批风格、模型、提示词结构、尺寸、颜色指引和参考图都相同的相关素材时。用户可以在 SpriteCook 应用中微调并保存预设,然后让智能体通过 MCP 使用这些预设。
该技能应与 spritecook-workflow-essentials 以及相关的生成技能配合使用。
何时使用预设
在以下情况使用预设:
- 用户明确说“使用我的预设”;
- 用户点名某个已保存的预设;
- 用户要求生成与某个已保存 SpriteCook 设置匹配的素材;
- 用户暗示要与某个已命名的已保存风格或工作流保持延续,例如“用我的角色预设来做这个”。
不要在普通生成请求中默认浏览预设。如果用户没有提到或暗示预设,应使用常规的 SpriteCook 生成工作流。
只有在用户要求保存预设或要求为将来保留这些设置时,才使用 save_private_preset。
获取与应用
- 调用 list_presets(query=...),传入用户的预设名称或意图。
- 优先按标题选择最佳匹配,其次参考 mode、status、description 和 settings。
- 如果仍有多个可能匹配的预设,在生成前先提出一个简短的澄清问题。
- 调用 get_preset_settings(preset_id=...) 获取所选预设。
- 将返回的设置映射到相关的 MCP 工具:
- prompt -> 基础提示词或提示词指引。
- themeText -> theme。
- styleText -> style。
- width、height、pixel、bgMode、aspectRatio、smartCropEnabled、smartCropMode、detailedModel、resolution、quality 和 colors -> 在目标工具支持时映射为对应的生成参数。
- settings.reference.styleAssetIds -> generate_game_art 的 style_asset_ids,最多 10 个资产 ID。
- settings.reference.contextAssetId -> generate_game_art 的 reference_asset_id。
- settings.reference.editAssetId -> generate_game_art 的 edit_asset_id,仅在用户正在修改该特定图像时使用。
- tilesetPerspective、tilesetPieceSet 和 tilesetElevation -> generate_tileset 的设置。
应保留用户请求的主体或改动。预设应指导风格与设置,不应覆盖用户的新意图,除非用户要求完全重复。
参考图
私有草稿预设可以返回自有资产 ID:
- settings.reference.styleAssetIds
- settings.reference.contextAssetId
- settings.reference.editAssetId
已发布预设可以返回冻结的预设媒体 URL:
- settings.reference.styleUploadUrls
- settings.reference.contextUploadUrl
- settings.reference.editUploadUrl
使用规则:
- 调用 generate_game_art 时,将 settings.reference.styleAssetIds 直接用作 style_asset_ids,最多传入 10 个 ID。
- 当预设提供一个具体的视觉/上下文参考时,将 settings.reference.contextAssetId 用作 reference_asset_id。
- 仅当用户正在修改该特定图像时,才将 settings.reference.editAssetId 用作 edit_asset_id。
- 将风格资产 ID 视为环境风格指引图:它们为新相关素材确立风格、调色板、比例和渲染方式。除非用户要求强调某个具体细节,提示词无需再次说明它们是风格参考。
- 如果预设返回多个风格资产 ID,而目标工具只接受一个,优先使用第一个风格资产,除非用户要求另选。
- 如果预设返回的上传 URL 无法被目标 MCP 生成工具使用,仍应使用文本/模型/尺寸/颜色设置,并说明该媒体参考无法通过该工具应用。
保存预设
仅在用户要求保存预设后,才使用 save_private_preset(...)。
- 预设只保存为私有草稿。不要发布、分享或提交任何内容进行审核。
- 应包含对可重复性重要的设置:提示词模式、主题、风格、模型、尺寸、像素模式、背景模式、智能裁剪、质量、颜色,以及受支持的参考/编辑/风格图像。
- 当用户希望保存的预设包含这些图像时,使用 style_references、reference_image、edit_image 和 preview 资产 ID。
- 如果因私有预设数量上限或参考资产不可用而保存失败,简要说明用户可见的问题,不要用缺失的参考重试,除非用户要求。
实用示例
当用户说“用我的角色预设做一个蓝色巫师待机精灵”时:
- list_presets(query="character")
- 选择可能的角色预设。
- get_preset_settings(preset_id="...")
- 使用预设的风格/设置加上新主体进行生成:蓝色巫师待机精灵。
限制
资料未提供该技能的具体收费、价格、支持平台、生成效果保证等信息。预设的可用性取决于 SpriteCook 应用中已保存的预设及 MCP 工具的支持范围;部分媒体参考可能无法被目标生成工具使用。