spritecook-use-presets

SpriteCook プリセットの使用

このスキルは、spritecook-workflow-essentials および関連する生成スキルと併用してください。

プリセットは、保存済みの SpriteCook の設定とプロンプトのレシピです。ユーザーが後で一貫性のある類似した出力を得られるようにすることを目的としています。特に、同じスタイル、モデル、プロンプト構成、寸法、色の指定、参照画像を使った関連アセットのコレクションが必要な場合に役立ちます。ユーザーは SpriteCook アプリでプリセットを微調整して保存し、その後 MCP を通じてエージェントにプリセットの使用を依頼できます。

プリセットを使用するタイミング

• ユーザーが use my preset と明示する場合、保存済みのプリセット名を指定する場合、または保存済みの SpriteCook 設定に合わせたアセットを依頼する場合は、プリセットを使用します。
• 「これにはキャラクターのプリセットを使って」のように、名前付きの保存済みスタイルやワークフローとの継続性をユーザーが示唆する場合は、プリセットを使用します。
• 通常の生成依頼では、デフォルトでプリセットを検索しないでください。ユーザーがプリセットに言及も示唆もしない場合は、通常の 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。アセット ID は最大 10 個です。
   • 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 に直接使用します。ID は最大 10 個まで渡せます。
• プリセットで特定の視覚的・文脈的参照が指定されている場合は、settings.reference.contextAssetId に reference_asset_id を使用します。
• edit_asset_id は、ユーザーがその特定の画像を変更する場合に限り、settings.reference.editAssetId に使用します。
• スタイルアセット ID は、全体的なスタイルガイド画像として扱います。新しい関連アセットのスタイル、パレット、プロポーション、描画表現を決定します。ユーザーが特定の詳細を強調するよう求めない限り、プロンプトでスタイル参照であることを言い直す必要はありません。
• プリセットから複数のスタイルアセット ID が返されても、対象ツールが 1 つしか受け付けない場合は、ユーザーから別の指定がない限り、最初のスタイルアセットを優先します。
• プリセットから返されたアップロード 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. プリセットのスタイル／設定に、新しい題材 blue wizard idle sprite を加えて生成します。