spritecook-use-presets

使用 SpriteCook 预设

将此技能与 spritecook-workflow-essentials 及相关生成技能配合使用。

预设是保存的 SpriteCook 设置和提示词配方。它们旨在帮助用户日后生成风格一致、相似的内容，尤其是在需要一组风格、模型、提示词结构、尺寸、配色指导和参考图像相同的相关素材时。用户可以在 SpriteCook 应用中微调并保存预设，然后通过 MCP 让 Agent 使用这些预设。

何时使用预设

• 当用户明确说 use my preset、提到某个已保存的预设，或要求生成与已保存的 SpriteCook 设置相匹配的素材时，使用预设。
• 当用户暗示要延续某种具名的已保存风格或工作流时，例如 use my character preset for this，使用预设。
• 对于一般生成请求，默认不要浏览预设。如果用户没有提到或暗示要使用预设，请使用常规的 SpriteCook 生成工作流。
• 只有在用户要求保存预设或为将来保留这些设置时，才使用 save_private_preset。

获取并应用

1. 调用 list_presets(query=...)，传入用户提供的预设名称或意图。
2. 依次根据标题、模式、状态、描述和设置，选择最匹配的预设。
3. 如果仍有多个可能的预设，请在生成前简洁地询问用户以作澄清。
4. 对选定的预设调用 get_preset_settings(preset_id=...)。
5. 将返回的设置映射到相关 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 设置。
6. 保留用户要求的主题或修改内容。预设应提供风格和设置指导；除非用户要求完全复刻，否则不应覆盖用户的新意图。

参考图像

• 私有草稿预设可能会返回用户拥有的素材 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 和预览资源 ID。
• 如果因私人预设数量上限或参考资源不可用而保存失败，请简要说明用户遇到的问题；除非用户提出要求，否则不要在缺少参考图的情况下重试。

实用模式

当用户说 Use my character preset for a blue wizard idle sprite 时：

1. list_presets(query="character")
2. 选择最可能的角色预设。
3. get_preset_settings(preset_id="...")
4. 使用该预设的风格／设置以及新的主体“蓝色巫师待机精灵图”进行生成。