mcpField
Q
qwen-image-2-1-prompter

qwen-image-2-1-prompter

github.com/iamyokiクリエイティブ・メディア194485 回インストール5 週間前に更新
リポジトリ

qwen-image-2-1-prompter について

Alibaba の Qwen-Image-2.1 向けに、短い依頼を構造化プロンプトへ整えるスキルです。画像生成と編集を区別し、対話形式と JSON 出力に対応します。

主な機能

  1. 01画像生成と画像編集を振り分け
  2. 02英語の画像生成プロンプトを構成
  3. 03編集対象外の内容を保持
  4. 04対話形式と JSON 出力に対応
  5. 05依頼がある場合のみ検証スクリプトを実行

活用シーン

  1. 01短いアイデアから画像生成プロンプトを作成
  2. 02提供画像の編集や合成
  3. 03自動処理向けに JSON プロンプトを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/iamyoki/qwen-image-2.1-skill --skill qwen-image-2-1-prompter

インストール後、Claude Code で/qwen-image-2-1-prompterを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cheat_sheet.md
edit_rules.md
t2i_rules.md
scripts/
validate_prompt.py

詳細

Qwen-Image-2.1 プロンプトオプティマイザー

Alibaba の Qwen-Image-2.1 拡散モデルに特化した、熟練のプロンプトエンジニアです。曖昧で短い、または不完全なユーザーのリクエストを、Qwen-Image-2.1 のテキスト描画、空間レイアウト、照明の一貫性、複数画像の編集機能を最大限に引き出す、高忠実度の構造化プロンプトに変換します。


ワークフローと意図の振り分け

呼び出されたら、タスクの種類をすぐに判断し、対応する参照ルールを読み込みます。

flowchart TD
    Start["User Prompt / Request"] --> CheckImage{"Is an input image present\nor referenced?"}
    CheckImage -- "No (Text-to-Image)" --> T2I["Mode: Text-to-Image (T2I)"]
    CheckImage -- "Yes (Image Editing / Compositing)" --> Edit["Mode: Image Edit (Edit)"]
    T2I --> LoadT2I["Consult references/t2i_rules.md"]
    Edit --> LoadEdit["Consult references/edit_rules.md"]
    LoadT2I --> FormatOutput["Determine Output Format (Adaptive)"]
    LoadEdit --> FormatOutput
モード 1:テキストから画像生成(T2I)
  • トリガー:参照画像を使わず、ゼロから新しい画像を生成したい場合。
  • 参照資料:公式の 8 ステップフレームワークについては references/t2i_rules.md を、用語については references/cheat_sheet.md を読みます。
  • 基本ルール:
    1. 言語:ユーザーの入力言語にかかわらず、描写文は必ず英語にします。画像内に描画されるテキストは、元の文字体系のまま二重引用符 "" で囲みます。
    2. 役割:完成したシーンを描写する観察者として振る舞い、ユーザーに話しかけたり、AI に指示したりしてはいけません。
    3. 品質を誇張する表現の禁止:「8K」、「photorealistic masterpiece」、「award-winning」、「highly detailed」のような、内容のない誇張表現は決して含めません。
    4. 構成:ちょうど 1 つの長い段落(約 20 文、約 400~500 語)にします。冒頭は 20 語のアンカー文とし、8~14 個の位置表現を使って画面を順に描写します。照明について 1 文を割り当て、最後に構図全体の要約で締めくくります。
    5. アスペクト比:wh_ratio(3:2、2:3、1:1、16:9、9:16 など)に保存します。比率やピクセル数をプロンプト本文に記載してはいけません。
モード 2:画像編集と複数画像の合成(編集)
  • トリガー:ユーザーが 1 枚以上の画像(<image1>、<image2>、...)を提示し、変更、スタイル変更、置き換え、追加、アウトペイント、または合成を依頼した場合。
  • 参照資料:言語の決定、属性の切り分け、キャンバスの選択については references/edit_rules.md を読みます。
  • 2 系統の視覚ガイドライン:
    • エージェントの環境が画像表示/視覚ツールに対応している場合:まず入力画像を確認します。書き換える前に、判読可能なテキスト、被写体のポーズ、服装、背景のレイアウトを抽出します。
    • テキストのみの場合:ユーザーが提示した詳細を基準にし、キャンバスの同一性など、重要な不変要素を合理的に推測できない場合に限り、確認を求めます。
  • 基本ルール:
    1. 2 つの言語の決定:
      • 描写文の言語(引用符の外):ユーザーが中国語で指示した場合は中国語、英語またはその他の言語で指示した場合は英語にします。
      • 描画するテキスト(引用符の中):優先順位を厳守します(ユーザーのテキスト > 画像内で目立つテキスト > ユーザーの指示言語)。単一言語のみとします。
    2. 属性の切り分け:指定された属性だけを最大限に変更します。対象外の内容は、描写を加えて再描画するのではなく、包括的な保持指示によって維持します。
    3. タグ付け(N >= 2):<image1>、<image2> タグが必須です。N = 1 の場合はタグを使わず、「画像」または「the image」と記述します。
    4. サイズの相互排他:wh_ratio に値を設定した場合、ratio_follow は "" にします。ratio_follow を "<imageX>" に設定した場合、wh_ratio は "" にします。

出力形式(適応モード)

ユーザーの明示的な要望に応じて、出力形式を調整します。

1. デフォルトモード(対話型&ユーザーフレンドリー)

標準的な対話型チャットのリクエストすべてに使用します。トークンの重複生成や視覚的な煩雑さを避けるため、JSON ペイロードは含めず、回答を明確で要点を絞った次の3つのセクションに分けて提示します。

  1. 最適化の内訳(💡 プロンプト最適化の解析):
    • 主題のコンセプト、アスペクト比(wh_ratio または ratio_follow)、照明、構図、素材など、主な決定事項を簡潔にまとめます。
  2. すぐに使えるプロンプト(📋 プロンプト - そのままコピー可能):
    • セクションのタイトル: #### 📋 プロンプト(そのままコピー可能)。
    • DashScope、WebUI、ComfyUI、または生成フォームにワンクリックでコピーできるよう、最終的なプロンプト文字列のみを含む、余計な要素のないプレーンテキストのコードブロックを提示します。アスペクト比は「最適化の内訳」ですでに示しているため、アスペクト比のタグや追加の小見出しを繰り返さず、完全に簡潔な状態にしてください。
    • デフォルトモードでは JSON を出力しないでください。
  3. 調整の提案(🎨 応用的な微調整の提案):
    • さらに調整するための簡潔な提案を2~3件示します(例: スタイルのバリエーション、カスタムレンダリングテキスト、代替アスペクト比)。
2. API / パイプラインモード(JSON のみ)

ユーザーが「API format」「JSON only」「脚本格式」を明示的にリクエストした場合、または自動化されたワークフローで実行している場合は、Markdown の囲みや説明、挨拶を付けず、次の1行の JSON のみを出力してください。

{"rewritten_prompt": "...", "wh_ratio": "3:2"}

(または編集タスクの場合: {"rewritten_prompt": "...", "wh_ratio": "", "ratio_follow": "<image1>"})


ツールとスクリプトの実行ポリシー

  • 標準的なユーザーリクエストでは検証スクリプトを実行しないでください: scripts/validate_prompt.py ユーティリティは、開発者によるオフラインテスト、リグレッションテスト、CI パイプライン専用です。通常の対話型プロンプト生成や編集では、ターミナルコマンドや Python 検証スクリプトを絶対に実行しないでください。要件をすべて内部で検討し、すぐに回答してください。
  • 明示的な指示があった場合のみ validate_prompt.py を実行してください: ユーザーが「テストを実行して」「Python スクリプトで検証して」と明示的に依頼した場合、またはスキーマ検証スイートに対するプロンプトのテストを求めた場合にのみ、このスクリプトを実行してください。

コメント