用途:这是 SpriteCook 的共享工作流规则技能,在编辑器已连接 SpriteCook MCP 服务器时,配合图像生成、UI-kit 构建、动画、导入、去背景与资产整理等技能一起使用。安装方式为 npx spritecook-mcp setup,或参考 spritecook.ai。
主要能力与用法:
- 预检:批量或多资产工作流前先用 get_credit_balance 检查额度;以 sprite_url 作为规范下载地址,仅在需要时用 spritesheet_url;把重要 asset_id 存入本地清单;同一主体的后续生成或动画应复用规范 asset_id;丢失 ID 时用 list_recent_assets(limit=...) 恢复。
- 凭据安全:不得要求用户把 API key 粘贴到聊天、提示词、代码块、命令或生成文件中,也不得打印、持久化或内联密钥与 Authorization 头;优先使用 MCP 工具、预签名 URL 或本地连接器;无认证助手时停止并请用户配置。
- 异步操作:generate_game_art、generate_tileset、remove_background、generate_character、generate_character_animations、animate_game_art 均为异步;按返回的 poll.tool 与 poll.arguments 轮询,不自行发明端点;用 operation_id 作通用标识并保留 job_id/run_id;仅在工具支持且有界等待时传 wait_seconds;成功时消费规范资产,若出现 warning.code="asset_output_unavailable" 则执行其 recovery 调用。
- 资产库:本地文件转资产用 spritecook-upload-assets 配合 create_asset_upload 与 finalize_asset_upload;小 data URL 或 base64 用 import_asset;自有资产去背景用 remove_background(asset_id=...),本地图像数据用 remove_background(image=...);用 update_asset_label 改善命名。
- UI Kit:完整界面用 spritecook-build-ui-kits,先建或选一个概念再生成 sheet 并抽取组件;已有概念可传 create_ui_kit(concept_asset_id=...);单个 UI 资产用 generate_game_art(mode="ui");UI-kit 默认模型为 gpt-image-2,Gemini 概念需账号支持 2K;定稿前检查 extraction quality_summary。
- 预设:用户指定预设时先 list_presets(query=...) 再 get_preset_settings(preset_id=...) 并应用;预设是保存的设置与参考指引,不是独立生成路径;私有草稿预设可返回 styleAssetIds、contextAssetId、editAssetId,分别映射到 style_asset_ids(最多 10 个)、reference_asset_id、edit_asset_id;已发布预设可返回 styleUploadUrls 等,仅在目标工具支持时使用;save_private_preset 仅在用户明确要求时调用。
- 默认值:smart_crop_mode 默认 "tightest",仅在用户明确要求时用 "power_of_2";模型 gemini-2.5-flash-image 最便宜,gemini-3.1-flash-image 为普通静图推荐默认,gemini-3-pro-image 最贵;专项工作流默认值优先。
- 资产清单:以 asset_id 为主标识,本地文件存 12 位 SHA-256 前缀 sha12,条目含 asset_id、sha12 与可选 label,建议用 spritecook-assets.json;生成新参考资产或索要 ID 前先查清单,复用本地文件前先算 sha12 匹配。
- 下载:近期资产恢复优先 list_recent_assets(limit=...);sprite_url 为主 URL,spritesheet_url 为可选次生产物;单资产可用 get_asset_metadata(asset_id);url、pixel_url、raw_url 为兼容别名;避免依赖 _presigned_pixel_url 等内部字段与直接认证下载端点。
限制:需先连接 SpriteCook MCP 服务器;具体工具可用性、额度与模型支持取决于账号;资料未提供价格、平台与效果数据。