qwen-image-2-1-prompter について
Alibaba の Qwen-Image-2.1 向けに、短い依頼を構造化プロンプトへ整えるスキルです。画像生成と編集を区別し、対話形式と JSON 出力に対応します。
主な機能
- 01画像生成と画像編集を振り分け
- 02英語の画像生成プロンプトを構成
- 03編集対象外の内容を保持
- 04対話形式と JSON 出力に対応
- 05依頼がある場合のみ検証スクリプトを実行
活用シーン
- 01短いアイデアから画像生成プロンプトを作成
- 02提供画像の編集や合成
- 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.mdedit_rules.mdt2i_rules.mdscripts/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を読みます。 - 基本ルール:
- 言語:ユーザーの入力言語にかかわらず、描写文は必ず英語にします。画像内に描画されるテキストは、元の文字体系のまま二重引用符
""で囲みます。 - 役割:完成したシーンを描写する観察者として振る舞い、ユーザーに話しかけたり、AI に指示したりしてはいけません。
- 品質を誇張する表現の禁止:「8K」、「photorealistic masterpiece」、「award-winning」、「highly detailed」のような、内容のない誇張表現は決して含めません。
- 構成:ちょうど 1 つの長い段落(約 20 文、約 400~500 語)にします。冒頭は 20 語のアンカー文とし、8~14 個の位置表現を使って画面を順に描写します。照明について 1 文を割り当て、最後に構図全体の要約で締めくくります。
- アスペクト比:
wh_ratio(3:2、2:3、1:1、16:9、9:16など)に保存します。比率やピクセル数をプロンプト本文に記載してはいけません。
- 言語:ユーザーの入力言語にかかわらず、描写文は必ず英語にします。画像内に描画されるテキストは、元の文字体系のまま二重引用符
モード 2:画像編集と複数画像の合成(編集)
- トリガー:ユーザーが 1 枚以上の画像(
<image1>、<image2>、...)を提示し、変更、スタイル変更、置き換え、追加、アウトペイント、または合成を依頼した場合。 - 参照資料:言語の決定、属性の切り分け、キャンバスの選択については
references/edit_rules.mdを読みます。 - 2 系統の視覚ガイドライン:
- エージェントの環境が画像表示/視覚ツールに対応している場合:まず入力画像を確認します。書き換える前に、判読可能なテキスト、被写体のポーズ、服装、背景のレイアウトを抽出します。
- テキストのみの場合:ユーザーが提示した詳細を基準にし、キャンバスの同一性など、重要な不変要素を合理的に推測できない場合に限り、確認を求めます。
- 基本ルール:
- 2 つの言語の決定:
- 描写文の言語(引用符の外):ユーザーが中国語で指示した場合は中国語、英語またはその他の言語で指示した場合は英語にします。
- 描画するテキスト(引用符の中):優先順位を厳守します(ユーザーのテキスト > 画像内で目立つテキスト > ユーザーの指示言語)。単一言語のみとします。
- 属性の切り分け:指定された属性だけを最大限に変更します。対象外の内容は、描写を加えて再描画するのではなく、包括的な保持指示によって維持します。
- タグ付け(N >= 2):
<image1>、<image2>タグが必須です。N = 1 の場合はタグを使わず、「画像」または「the image」と記述します。 - サイズの相互排他:
wh_ratioに値を設定した場合、ratio_followは""にします。ratio_followを"<imageX>"に設定した場合、wh_ratioは""にします。
- 2 つの言語の決定:
出力形式(適応モード)
ユーザーの明示的な要望に応じて、出力形式を調整します。
1. デフォルトモード(対話型&ユーザーフレンドリー)
標準的な対話型チャットのリクエストすべてに使用します。トークンの重複生成や視覚的な煩雑さを避けるため、JSON ペイロードは含めず、回答を明確で要点を絞った次の3つのセクションに分けて提示します。
- 最適化の内訳(💡 プロンプト最適化の解析):
- 主題のコンセプト、アスペクト比(
wh_ratioまたはratio_follow)、照明、構図、素材など、主な決定事項を簡潔にまとめます。
- 主題のコンセプト、アスペクト比(
- すぐに使えるプロンプト(📋 プロンプト - そのままコピー可能):
- セクションのタイトル:
#### 📋 プロンプト(そのままコピー可能)。 - DashScope、WebUI、ComfyUI、または生成フォームにワンクリックでコピーできるよう、最終的なプロンプト文字列のみを含む、余計な要素のないプレーンテキストのコードブロックを提示します。アスペクト比は「最適化の内訳」ですでに示しているため、アスペクト比のタグや追加の小見出しを繰り返さず、完全に簡潔な状態にしてください。
- デフォルトモードでは JSON を出力しないでください。
- セクションのタイトル:
- 調整の提案(🎨 応用的な微調整の提案):
- さらに調整するための簡潔な提案を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 スクリプトで検証して」と明示的に依頼した場合、またはスキーマ検証スイートに対するプロンプトのテストを求めた場合にのみ、このスクリプトを実行してください。
コメント
Markdown 対応