qwencloud-image-generation

Qwen Image Generation

Wan および Qwen Image モデルを使用して、画像を生成・編集します。テキストからの画像生成、参照画像の編集（スタイル変換、被写体の一貫性維持、複数画像の合成、テキストの描画）、テキストと画像を交互に出力する機能に対応しています。 このスキルは qwencloud/qwencloud-ai の一部です。

スキルディレクトリ

このスキルの内部ファイルを使用して、実行方法を確認してください。デフォルトのパスで問題が発生した場合や、詳細が必要な場合は、必要に応じてリファレンスファイルを読み込んでください。

場所	用途
scripts/image.py	デフォルトの実行方法 — 同期／非同期、アップロード、ダウンロード
references/execution-guide.md	フォールバック：curl（同期／非同期）、コード生成
references/prompt-guide.md	プロンプトの式、スタイルキーワード、negative_prompt、prompt_extend の選択
references/api-guide.md	API の補足
references/sources.md	公式ドキュメントの URL

セキュリティ

API キーや認証情報を平文で出力してはいけません。 常に変数参照を使用してください（シェルでは $QWENCLOUD_API_KEY、Python では os.environ["QWENCLOUD_API_KEY"]）。スクリプトは QWENCLOUD_API_KEY、次に QWEN_API_KEY、最後に DASHSCOPE_API_KEY を受け付けます。認証情報の確認や検出では、必ず平文を使用せず、状態（「設定済み」／「未設定」、「有効」／「無効」など）のみを報告してください。秘密情報を含む可能性がある .env や設定ファイルの内容は、決して表示しないでください。

API キーが設定されていない場合、ユーザーに直接キーを提供するよう求めてはいけません。 代わりに、プレースホルダー（QWENCLOUD_API_KEY=sk-your-key-here）を含む .env ファイルの作成を支援し、実際のキーを QwenCloud Console から取得して置き換えるよう案内してください。実際のキー値を書き込むのは、ユーザーが明示的に要求した場合に限ります。

キーの互換性

スクリプトは標準の QwenCloud API キー（sk-...）とToken Plan キー（sk-sp-...）の両方に対応しています。Token Plan キーは、対応する画像モデル向けに Token Plan エンドポイントへ自動的に振り分けられます。Token Plan のモデルカタログを参照してください。CDN にアクセスできない場合は、ローカルの代替ファイルを使用してください。

Token Plan では curl を使用せず、必ず同梱の Python スクリプトを使用してください。

Coding Plan キー（こちらも sk-sp- プレフィックスですが、Coding Plan サブスクリプションで購入したキー）は使用できません。画像生成モデルは Coding Plan では利用できません。スクリプトは起動時にキーの種類を検出し、それに応じて振り分けます。qwencloud-ops-auth がインストールされている場合は、詳細について references/codingplan.md を参照してください。

API キーを公開せずに、キーの種類を検出します。

python3 -c "
import sys; sys.path.insert(0, 'scripts')
from qwencloud_lib import detect_api_key_type
print(detect_api_key_type('scripts/qwencloud_lib.py'))
"

出力	意味
token-plan	Token Plan キーが検出されました（sk-sp- プレフィックス）
payg	標準の PAYG キーが検出されました
not-set	環境内に API キーが見つかりません

モード選択ガイド

モードを選ぶ前に、最新の QwenCloud 画像生成モデルカタログを取得して読み込んでください。カタログには、モードに応じたモデルの推奨、モデル一覧、基本的なモデル情報、互換性に関する注意事項、デフォルトのモデルが記載されています。CDN にアクセスできない場合は、ローカルの代替ファイルを使用してください。

モデルの選択

🚫 重大 — ユーザー指定のパラメーターを決して上書きしないでください。 ユーザーがプロンプトまたはリクエスト JSON でモデルを明示的に指定した場合、必ずそのモデルをそのまま使用してください。次のことは禁止されています。

• 「より適している」または新しいモデルに置き換えること（たとえば、タスクが「複数機能を使う作業のように見える」という理由で、ユーザー指定の wan2.6-t2i を wan2.7-image に変更すること）
• ユーザーが求めていないパラメーターを追加すること（thinking_mode、color_palette、bbox_list、スタイルのヒントなど）
• 明示的に指定されたユーザーの選択を「最適化」すること

以下のモード／モデルに関するガイダンスは、ユーザーがモデルを指定していない場合に限り適用されます。ユーザー指定のモデルで要求された処理を実現できない場合（API の厳格な制約など）は、可能であれば指定どおりに実行してください。実行できない場合は、その制約をユーザーに伝えて、ユーザー自身に判断を委ねてください。黙って別のモデルに切り替えてはいけません。

最新のモデルファミリー、デフォルト、推奨事項、互換性、制限については、上記リンク先の画像生成モデルカタログを参照してください。

1. ユーザーがモデルを指定している → 必須：指定されたモデルをそのまま使用してください — 代替したり、「最適化」したり、要求されていないパラメーターを追加したりしないでください。
2. モデルの選択が要件、シナリオ、または料金に左右される場合は、qwencloud-model-selector スキルを参照してください。
3. モデルが指定されていない → モデルカタログに記載されている最新のデフォルトまたはタスク固有の推奨モデルを選択してください。ユーザーの要求する処理がモデルの文書化された厳格な制約に抵触する場合は、その制約を説明してユーザーに判断を委ねてください。明示的に選択されたモデルを黙って変更してはいけません。

⚠️ 重要：モデルカタログはある時点のスナップショットであり、古くなっている可能性があります。モデルの提供状況は頻繁に変わります。モデルを選択する前に、必ず最新かつ正式な情報として公式モデル一覧を確認してください。

モデルの詳細：特定のモデルについて詳しく知りたい場合は、その詳細ページを案内してください：https://www.qwencloud.com/models/<model-name>（<model-name> を正確なモデル ID に置き換えます。例：wan2.7-image-pro → https://www.qwencloud.com/models/wan2.7-image-pro）。URL 内のモデル名を変更したり、推測したりしてはいけません。

動的なモデル情報の照会：qwencloud-model-selector スキルまたは QwenCloud CLI（qwencloud models info <model>）が利用可能な場合は、リアルタイムのモデル情報を取得するために使用してください。CLI の利用には認証が必要です。ログイン手順については qwencloud-usage スキルを参照してください。

実行

⚠️ 複数の成果物：1 回のセッションで複数のファイルを生成する場合、上書きを防ぐため、各ファイル名に数値のサフィックスを付けてください（例：out_1.png、out_2.png）。

前提条件

• API キー：QWENCLOUD_API_KEY、QWEN_API_KEY、DASHSCOPE_API_KEY の順に、平文を表示しない方法のみで設定を確認してください（例：シェルでは [ -n "$QWENCLOUD_API_KEY" ]）。報告するのは「設定済み」または「未設定」のみとし、キーの値は決して表示しないでください。未設定の場合、利用可能であれば qwencloud-ops-auth スキルを実行してください。利用できない場合は、QwenCloud Consoleからキーを取得し、.env ファイル（プロジェクトルートまたはカレントディレクトリで echo 'QWENCLOUD_API_KEY=sk-your-key-here' >> .env を実行）または環境変数で設定するよう、ユーザーに案内してください。スクリプトはカレント作業ディレクトリとプロジェクトルートの .env を検索します。スキルは個別にインストールされることがあるため、qwencloud-ops-auth が存在すると決めつけないでください。 注：スクリプトは、エクスポート済みの環境変数に加えて、カレントディレクトリとプロジェクトルートの .env を自動的に読み込みます。シェルの確認で $QWENCLOUD_API_KEY が「未設定」と表示されても、スクリプトが失敗するとは限りません。.env 内でキーが見つかる可能性があります。シェルの確認結果は参考情報としてのみ扱ってください。キーがどこにも見つからない場合はスクリプトが明確なエラーを出して終了するため、最終的な確認方法はスクリプトを実行することです。
• Python 3.9 以降（標準ライブラリのみ、pip install は不要）

環境の確認

初回実行の前に、Python が利用可能であることを確認してください。

python3 --version  # must be 3.9+

python3 が利用できない場合、またはバージョンが 3.9 未満の場合、PAYG では **Path 2（curl）**を使用できます。Token Plan では、代わりに Python 3.9 以降をインストールする必要があります。

デフォルト：スクリプトを実行

スクリプトのパス：スクリプトは、このスキルのディレクトリ（この SKILL.md を含むディレクトリ）内の scripts/ サブディレクトリにあります。まず、このスキルのインストール先ディレクトリを特定し、その後、スクリプトの実行には必ず完全な絶対パスを使用してください。 スクリプトが現在の作業ディレクトリにあると想定しないでください。実行前に cd でディレクトリを切り替えないでください。

実行に関する注意：すべてのスクリプトはフォアグラウンドで実行し、標準出力を待ってください。バックグラウンドでは実行しないでください。

引数の確認：最初に python3 <this-skill-dir>/scripts/image.py --help を実行し、利用可能な引数をすべて確認してください。

# Text-to-image (use the default from the CDN model catalog)
python3 <this-skill-dir>/scripts/image.py \
  --request '{"prompt":"A cozy flower shop with wooden door"}' \
  --output output/qwencloud-image-generation/images/out.png \
  --print-response

# Image editing with reference images (wan2.6-image)
python3 <this-skill-dir>/scripts/image.py \
  --model wan2.6-image \
  --request '{"prompt":"Apply watercolor painting style to this photo","reference_images":["https://img.alicdn.com/imgextra/i1/NotRealJustExample/photo.jpg"],"n":1,"size":"1K"}' \
  --output output/qwencloud-image-generation/images/out.png \
  --print-response

# z-image-turbo (sync-only, no n; size omitted → server default 1024*1536)
python3 <this-skill-dir>/scripts/image.py \
  --model z-image-turbo \
  --request '{"prompt":"A sitting orange cat, realistic","prompt_extend":false}' \
  --output output/qwencloud-image-generation/images/out.png \
  --print-response

# qwen-image-3.0-pro (no size → auto-recommended resolution)
python3 <this-skill-dir>/scripts/image.py \
  --model qwen-image-3.0-pro \
  --request '{"prompt":"A poster reading \"限时特惠\"","enable_thinking":true}' \
  --output output/qwencloud-image-generation/images/out.png \
  --print-response

# qwen-mt-image-2.0 (API supports sync/async; bundled script uses async)
python3 <this-skill-dir>/scripts/image.py \
  --model qwen-mt-image-2.0 \
  --request '{"image_url":"https://example.com/poster_zh.jpg","source_lang":"zh","target_lang":"en"}' \
  --output output/qwencloud-image-generation/images/out.png \
  --print-response

その他の例（出力のインターリーブ、wan2.5-i2i、qwen-image-2.0-pro、qwen-image-plus）：execution-guide.md を参照してください。

引数	説明
--request '{...}'	JSON リクエスト本文
--file path.json	ファイルからリクエストを読み込みます
--async	非同期モードを強制します。スクリプトは、実装が非同期を使用する場合に自動的に非同期モードを有効にします。qwen-image-max のような同期専用モデルでは無視されます
--model ID	モデルを上書きします（現在のデフォルトについては、上記のモデルカタログを確認してください）
--output path	画像を指定したパスに保存します（複数画像を出力する場合はディレクトリを指定します）。複数の画像を同じディレクトリに書き込むと、実行ごとの上書きを防ぐため、OSS URL の一意な識別子を使ってファイルに自動で名前が付けられます。明示的に指定したファイルパスが優先されます。上書きを避けるため、呼び出しごとに異なるファイル名を使用してください
--print-response	レスポンス JSON を標準出力に表示します

結果を確認

• 終了コードが 0 で、出力に output.results または output.task_id を含む有効な JSON がある → 成功
• 終了コードが 0 以外、HTTP エラー、空のレスポンス、またはエラー JSON → 失敗
• 非同期の場合：送信時に output.task_id が返され、ポーリングで task_status: SUCCEEDED に到達する必要があります
• 実行後の確認：出力ファイルが存在し、サイズが 0 でないことを確認してください（ls -la <output_path>）
• 必須 — 標準エラー出力のシグナル確認：結果を確認した後、コマンドの標準エラー出力に [ACTION_REQUIRED] または [UPDATE_AVAILABLE] がないか確認してください。いずれかのシグナルがある場合は、ユーザーに応答する前に、以下の更新の確認の指示に必ず従ってください。

失敗した場合

スクリプトが失敗した場合は、以下の診断表でエラー出力と一致する項目を探し、解決方法を確認してください。一致する項目がない場合は、別の方法として、curl コマンド（方法 2 — 同期および非同期）、コード生成（方法 3）、自律的な解決（方法 5）を説明する execution-guide.md を読んでください。

Python がまったく利用できない場合 → PAYG は方法 2（curl）を使用できます。Token Plan では Python 3.9 以降をインストールする必要があります。

エラーパターン	診断	解決方法
command not found: python3	Python が PATH にありません	python または py -3 を試してください。Python がない場合は Python 3.9 以降をインストールしてください
Python 3.9+ required	スクリプトのバージョンチェックに失敗しました	Python 3.9 以降にアップグレードしてください
型ヒント付近の SyntaxError	Python 3.9 未満です	Python 3.9 以降にアップグレードしてください
QWENCLOUD_API_KEY/QWEN_API_KEY/DASHSCOPE_API_KEY not found	API キーがありません	QwenCloud Console からキーを取得し、.env に追加します：echo 'QWENCLOUD_API_KEY=sk-...' >> .env。または、利用可能な場合は qwencloud-ops-auth を実行してください
HTTP 401	キーが無効、または一致していません	qwencloud-ops-auth を実行してください（非プレーンテキストの確認のみ）。キーが有効であることを確認してください
SSL: CERTIFICATE_VERIFY_FAILED	SSL 証明書の問題（プロキシ／社内ネットワーク）	macOS：Install Certificates.command を実行してください。それ以外の場合は SSL_CERT_FILE 環境変数を設定してください
URLError / ConnectionError	ネットワークに接続できません	インターネット接続を確認してください。プロキシ経由の場合は HTTPS_PROXY を設定してください
HTTP 429	レート制限されています	待機してから、バックオフを使って再試行してください
HTTP 5xx	サーバーエラーです	バックオフを使って再試行してください
PermissionError	出力を書き込めません	書き込み可能なディレクトリを --output で指定してください

クイックリファレンス

リクエストフィールド（共通）

フィールド	型	説明
prompt	string	生成する画像のテキスト説明（必須。画像翻訳には使用しません）
negative_prompt	string	画像に含めない内容（最大500文字）
size	string	解像度。カタログ掲載モデルの上限についてはモデルカタログを、記載のないモデル固有の値についてはAPIガイドまたは公式ドキュメントを参照してください
seed	int	再現性のための乱数シード [0, 2147483647]
model	string	モデル ID。現在のデフォルトモデルと対応モデルについては、上記のモデルカタログを確認してください
prompt_extend	bool	プロンプトの書き換えを有効にします（デフォルト：true。画像編集モードのみ）
enable_thinking	bool	qwen-image-3.0 のみ — 推論を強化します（デフォルト：true）。prompt_extend=true の場合のみ有効です
prompt_extend_mode	string	qwen-image-3.0 のみ — direct（DPE、デフォルト）または agent（APE。t2i のみ）

リクエストフィールド（wan2.7-image-pro / wan2.7-image — 多機能）

フィールド	型	説明
reference_images	string[]	画像 URL またはローカルパス（0～9件）
reference_image	string	画像 URL またはローカルパス1件（省略形）
size	string	1K、2K（デフォルト）、または 4K（pro のみ、t2i モード）。ピクセル寸法も指定できます
enable_sequential	bool	true：連続マルチ画像モード（n=1～12）。false（デフォルト）：単一／バッチモード（n=1～4）
n	int	生成する画像数。連続モード：1～12（デフォルト12）。非連続モード：1～4（デフォルト4）。画像ごとに課金されます。
thinking_mode	bool	品質向上のための推論強化を有効にします（デフォルト：true）。t2i（画像なし、非連続）のみ
bbox_list	List[List[List[int]]]	インタラクティブ編集領域。形式：[[[x1,y1,x2,y2],...], ...]。リストの長さは画像数と同じです。編集しない画像には空の [] を指定します
color_palette	array	カスタム配色（3～10色）。各色：{"hex":"#C2D1E6","ratio":"23.51%"}。比率の合計は100%です。非連続モードのみ
watermark	bool	「AI Generated」ウォーターマークを追加します（デフォルト：false）

注：thinking_mode はレイテンシーを増加させますが、品質を向上させます。enable_sequential は一貫性のある画像シーケンス（例：シーンをまたいで同じキャラクター）を生成します。

リクエストフィールド（wan2.6-image — 画像編集）

フィールド	型	説明
reference_images	string[]	編集モードでは画像 URL またはローカルパスを1～4件、インターリーブモードでは0～1件指定します
reference_image	string	画像 URL またはローカルパス1件（省略形。reference_images が優先されます）
enable_interleave	bool	false（デフォルト）：画像編集モード。true：テキストと画像を交互に出力します
n	int	編集モードで生成する画像数（1～4、デフォルト：1）。画像ごとに課金されます。
max_images	int	インターリーブモードでの最大画像数（1～5、デフォルト：5）。画像ごとに課金されます。
watermark	bool	「AI Generated」ウォーターマークを追加します（デフォルト：false）

その他のモデル

現在のモデル一覧とモデル固有の互換性の違いについては、上記リンク先のモデルカタログを参照してください。

画像翻訳リクエストフィールド

カタログから画像翻訳モデルを選択した場合は、image_url、source_lang、target_lang を使用し、prompt は送信しないでください。省略可能な ext オブジェクトには、ドメイン／スタイルのヒント、完全一致でスキップする単語、用語の組み合わせ、画像分割の設定を含められます。翻訳可能なテキストがない場合でも、タスクが成功すると課金されることがあります。

全パラメーターの表：詳細なパラメーターについては、api-guide.md を参照してください。

サイズの参考（wan2.6-image）

• 編集モード：1K（デフォルト、約1280×1280）または 2K（約2048×2048）
• インターリーブモード：[768×768, 1280×1280] の範囲内で、総ピクセル数を満たすピクセル寸法

一般的なアスペクト比：1280*1280（1:1）、960*1280（3:4）、1280*960（4:3）、720*1280（9:16）、1280*720（16:9）

レスポンスフィールド

フィールド	説明
image_url	生成された画像の URL（有効期間：24 時間）。別のスキルに連携する場合はこちらを使用してください。
image_urls	すべての画像 URL の配列（複数画像出力、wan2.6-image、qwen-image-edit）
image_count	生成された画像の数
local_path	ダウンロードした画像のローカルファイルパス。ユーザーへのプレビューや API を使用しない操作に使用してください。
local_paths	ローカルファイルパスの配列（複数画像出力）
interleaved_content	{type, text/image} オブジェクトの配列（インターリーブモード）
width / height	画像の寸法
seed	使用されたシード値

API の詳細

• 同期エンドポイント（wan2.6-t2i、wan2.6-image の編集、qwen-image-edit シリーズ、qwen-image-max、z-image-turbo）：POST /api/v1/services/aigc/multimodal-generation/generation
• 非同期エンドポイント（wan2.6 および旧バージョンの t2i）：X-DashScope-Async: enable を指定して POST /api/v1/services/aigc/image-generation/generation
• 非同期エンドポイント（wan2.5-i2i-preview、qwen-mt-image-2.0 のバンドルスクリプト経由ルート）：X-DashScope-Async: enable を指定して POST /api/v1/services/aigc/image2image/image-synthesis。画像翻訳 API 自体は同期・非同期の両方に対応していますが、現在 image.py は非同期での送信とポーリングを実装しています。
• 非同期エンドポイント（qwen-image-plus および qwen-image）：X-DashScope-Async: enable を指定して POST /api/v1/services/aigc/text2image/image-synthesis。qwen-image-max は同期専用のため、このルートを使用しないでください。
• wan2.6-t2i の解像度：総ピクセル数は [1280x1280, 1440x1440]、アスペクト比は [1:4, 4:1]
• wan2.6-image の解像度：編集モード [768x768, 2048x2048]、インターリーブモード [768x768, 1280x1280]、アスペクト比 [1:4, 4:1]
• 入力画像（wan2.6-image）：JPEG/JPG/PNG/BMP/WEBP、各辺 240～8000px、10MB 以下
• ローカルファイル：スクリプトが DashScope の一時ストレージに自動アップロードします（oss:// URL、TTL は 48 時間）。ローカルパスをそのまま渡せばよく、手動でアップロードする必要はありません。

  ⚠️ Token Plan の制限：Token Plan はローカルファイルのアップロードに対応していません。Token Plan のキー（sk-sp-...）を使用する場合は、ローカルパスではなく、一般にアクセス可能な https:// URL で参照画像を指定してください。

• 本番環境：デフォルトの一時ストレージは TTL が 48 時間、アップロード上限が 100 QPS です。本番環境、高並列処理、負荷テストには適していません。独自の OSS バケットを使用するには、.env で QWEN_TMP_OSS_BUCKET と QWEN_TMP_OSS_REGION を設定し、pip install alibabacloud-oss-v2 をインストールして、QWEN_TMP_OSS_AK_ID / QWEN_TMP_OSS_AK_SECRET または標準の OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET で認証情報を指定してください。最小権限（対象バケットのみの oss:PutObject と oss:GetObject）を持つ RAM ユーザーを使用してください。qwencloud-ops-auth がインストールされている場合は、完全なセットアップガイドについて references/custom-oss.md を参照してください。
• インターリーブ同期処理：ストリーミング（X-DashScope-Sse: enable + stream: true）が必要です。代わりにこのスクリプトから非同期モードを使用してください。

スキル間の連携

生成した画像を別のスキル（例：video-gen i2v、vision analyze）の入力として使用する場合：

• image_url を直接渡してください。ダウンロードしてローカルパスとして渡し直さないでください。
• 後続のスクリプトはすべて URL のプレフィックス（https://、oss://）を検出し、再アップロードせずにそのまま渡します。
• local_path は、ユーザーへのプレビューや API を使用しない操作（エディターで開くなど）にのみ使用してください。

シナリオ	使用する値
別のスキル（video-gen、vision、image-edit）に渡す	image_url（URL）
ユーザーに表示する／エディターで開く	local_path（ローカルファイル）

エラー処理

HTTP	意味	対応
401	API キーが無効または設定されていません	利用可能な場合は qwencloud-ops-auth を実行します。それ以外の場合は、ユーザーにキーの設定を依頼します（平文ではないことの確認のみ）
400	リクエストが不正です（プロンプトまたはサイズが無効）	パラメーターと制約を確認します
429	レート制限に達しました	指数バックオフで再試行します
5xx	サーバーエラー	指数バックオフで再試行します

使用状況と請求：qwencloud-usage スキルを使うと、使用状況、無料枠の上限、請求を直接確認できます。あるいは、ユーザーは QwenCloud コンソールにアクセスできます。 使用状況の分析 | 従量課金制の請求 | Coding Plan の請求

使用状況、請求、コンソールの URL を捏造、推測、作成してはいけません。 このスキルに記載されている正確なリンクのみを提示してください。ここに記載されていない URL は作成しないでください。

出力先

現在の作業ディレクトリを優先します。デフォルトのサブディレクトリ：./output/qwencloud-image-generation/。

書き込み禁止：このスキルのインストールディレクトリや、skills/ 階層内に出力ファイルを書き込んではいけません。生成したコンテンツはすべて、現在の作業ディレクトリ内の output/ またはユーザー指定のパスに保存してください。

トークンプランのサポート

一部の画像モデルでは、トークンプランのキー（sk-sp-...）をサポートしています。スクリプトはトークンプランのエンドポイントに自動的にルーティングします。

⚠️ トークンプランの制限：トークンプランではローカルファイルのアップロードはサポートされていません。トークンプランのキー（sk-sp-...）を使用する場合は、ローカルパスではなく、一般公開されている https:// URL で参照画像を指定してください。

対応モデル

最新の Token Plan モデルカタログを取得して読み込み、画像生成モデルとして正確に記載されているものを使用してください。CDN へのアクセスに失敗した場合は、ローカルの代替ファイルを使用してください。

トークンプランではサポートされていません

トークンプランのモデルカタログで画像対応と記載されていないモデルには、PAYG キーが必要です。

必須ヘッダー

User-Agent: qwencloud-skills は自動的に含まれます。

更新確認（実行後に必須）

スクリプトの実行後、stderr にアクションを示すシグナルがないか確認してください。スクリプトは更新状況を自動的に検出し、構造化シグナルを出力します。必ずそれらに対応してください。このセクションは、ユーザーが明示的に更新確認を依頼した場合にも適用されます。

シグナル：[ACTION_REQUIRED] qwencloud-update-check skill is not installed

stderr にこのシグナルが含まれる場合は、以下の選択肢をユーザーに提示し、処理を続ける前に回答を待ってください。黙ってスキップしてはいけません。

更新確認スキルがインストールされていません。このスキルは、qwencloud/qwencloud-ai の新機能やバグ修正に関する情報を提供します。

1. 今すぐインストール — インストールコマンドを実行します
2. 今回はスキップ — 今回は何もしません
3. 今後表示しない — この確認を今後表示しないようにします

ユーザーの回答後：

• ユーザーが 1 を選択 → npx skills add QwenCloud/qwencloud-ai --skill qwencloud-update-check -y を実行し、その後 python3 <this-skill-scripts-dir>/gossamer.py --dismiss を実行します
• ユーザーが 2 を選択 → python3 <this-skill-scripts-dir>/gossamer.py --dismiss を実行し、その後通常どおり続行します
• ユーザーが 3 を選択 → python3 <this-skill-scripts-dir>/gossamer.py --never-install を実行し、その後通常どおり続行します

シグナル：[UPDATE_AVAILABLE]

stderr にこのシグナルが含まれる場合は、stderr に表示されたバージョン情報と更新コマンドを含む簡潔な更新通知を、応答に追加してください。

stderr にシグナルがない場合

stderr に [ACTION_REQUIRED] も [UPDATE_AVAILABLE] も含まれていない場合は、対応不要です。スキルはインストール済みで最新です（または24時間以内のキャッシュを使用しています）。

ユーザーから明示的に依頼された場合

ユーザーから更新の確認を明示的に依頼された場合（例：「更新を確認して」「バージョンを確認して」）：

1. 隣接するスキルディレクトリ内で qwencloud-update-check/SKILL.md を探します。
2. 見つかった場合 — python3 <qwencloud-update-check-dir>/scripts/check_update.py --print-response を実行し、結果を報告します。
3. 見つからなかった場合 — 上記のインストール方法を提示します。

参考資料

• execution-guide.md — フォールバック手段（curl 同期／非同期、コード生成、自律実行）
• api-guide.md — API 補足ガイド
• sources.md — 公式ドキュメントの URL