qwencloud-model-selector

Qwen Model Selector（Advisor）

このスキルは、次の2つのモードで動作します。

1. 対話型アドバイザリー — 診断の質問を行い、適切なモデルを推奨します（診断フローを参照）。
2. スキル間の解決 — モデルの選択が必要な実行スキルに対し、ユーザーとのやり取りなしで素早くモデルを検索します。まず CDN の推奨情報を取得してください。CDN にアクセスできない場合は、 ローカルのフォールバックを使用してください。

モデル名を捏造してはいけません。CDN カタログに掲載されているモデル、または CLI から返されたモデルのみを推奨してください。 このスキルは qwencloud/qwencloud-ai の一部です。

🚫 重大 — ユーザーが指定したモデルを上書きしてはいけません。 ユーザー（または実行を依頼したスキル）がすでにモデルを明示している場合、このリクエストに対するこのスキルの役割は終了です。指定されたモデルをそのまま使用してください。代わりに「より適した」モデルや新しいモデルを推奨したり、ユーザーが求めていないパラメーター（思考モード、スタイルのヒント）を追加したりしてはいけません。以下の推奨や診断フローは、モデルが指定されていない場合にのみ適用されます。モデルが利用できるか確認し、利用不可または制限されている場合はユーザーに伝えて代替案を提示してもかまいませんが、最終判断はユーザーが行います。

スキルのディレクトリ

必要に応じて読み込んでください。モデルの一覧、デフォルト設定、推奨情報が必要な場合は、ドキュメント化された CDN のモデルカタログを取得してください。ユーザーから最新情報を明示的に求められない限り、ほかの外部 URL は取得しないでください。

cdn/ 以下のすべてのパスはローカルのフォールバックであり、第一の情報源ではありません。cdn/<path> については、まず https://alioth-intl.alicdn.com/skills-info/models/<path> を取得し、そのリクエストに失敗した場合にのみローカルファイルを使用してください。

場所	用途
references/cli-usage.md	CLI 優先のデータ戦略：CLI を使うタイミング、3 段階のログイン手順、表示ルール
references/error-handling.md	CLI エラーの分類と復旧手順（認証、未検出、ネットワークなど）
CDN のモデル推奨情報	スキル間の推奨情報、Token Plan の制約、思考モードのデフォルト設定。利用できない場合はローカルのフォールバックを使用してください
references/pricing-disclaimer.md	料金に関するガイダンスと必須の費用見積もりに関する免責事項（CN/EN）、コンソールへのリンク
references/pricing.md	安定した課金ガイダンスと CDN 料金情報のフォールバック
CDN のモデルカタログ	クロスドメインのモデルカタログスナップショット。利用できない場合はローカルのフォールバックを使用してください
references/sources.md	公式ドキュメントの URL（手動で参照する場合のみ）

前提条件

QwenCloud CLI の使用を強く推奨します。モデルの利用可否、料金、クォータを確認するための、リアルタイムで信頼できる情報源です。次のコマンドで確認してください。

qwencloud version

インストールされていない場合：

npm install -g @qwencloud/qwencloud-cli

Node.js 18 以上が必要です。CLI がなくても、CDN カタログから特定時点のナビゲーションやモデルに関する質問には回答できますが、現在の利用可否、正確な最新料金、アカウントのクォータは確認できません。

セキュリティと認証情報のモデル

QwenCloud には独立した認証情報システムが 2 つあります。混同しないでください。

認証情報	目的	指定方法
API キー（sk-... / sk-sp-...）	コードからモデル API を呼び出す	$DASHSCOPE_API_KEY / $QWEN_API_KEY 環境変数
CLI セッション	qwencloud CLI サブコマンドを認証する	qwencloud auth login（ブラウザーのデバイスフロー）

厳守事項（両方に適用）：

• 認証情報の値をプレーンテキストで絶対に出力しないでください。 変数参照を使い、状態（「設定済み」／「未設定」、「有効」／「無効」）のみを報告してください。.env や設定ファイルの内容は絶対に表示しないでください。
• 2 つのシステムを絶対に混同しないでください。 CLI が Not authenticated / AUTH_REQUIRED を返した場合は、3 ステップのデバイスフローログインを実行してください（cli-usage.md を参照）。API キーをユーザーに尋ねてはいけません。また、CLI の認証を解決するために $DASHSCOPE_API_KEY を設定しようとしてはいけません。

キーの種類の判別

モデルを推奨する前に、設定されている API キーから課金モードを判別してください（出力は token-plan、payg、または not-set とし、キーの値自体は絶対に出力しません）。

python3 -c "
import os
from pathlib import Path
env_file = Path('.env')
if not env_file.exists():
    for parent in [Path.cwd()] + list(Path.cwd().parents):
        if (parent / '.git').exists() or (parent / 'skills').is_dir():
            env_file = parent / '.env'
            break
if env_file.exists():
    for line in env_file.read_text().splitlines():
        line = line.strip()
        if not line or line.startswith('#') or '=' not in line:
            continue
        k, v = line.split('=', 1)
        k, v = k.strip(), v.strip().strip('\"').strip(\"'\")
        if k in ('QWEN_API_KEY', 'DASHSCOPE_API_KEY') and k not in os.environ:
            os.environ[k] = v
key = os.environ.get('QWEN_API_KEY') or os.environ.get('DASHSCOPE_API_KEY') or ''
print('token-plan' if key.startswith('sk-sp-') else 'payg' if key else 'not-set')
"

キーの種類	推奨範囲
token-plan	Token Plan モデルカタログを取得し、その中からのみ選択してください。エディションが不明な場合は、デフォルトで Team の上位版を使用してください。CDN にアクセスできない場合は、ローカルの代替データを使用してください。
payg	モデルカタログ全体
not-set	処理を中断しないでください — ユーザーに「どの方法を使う予定ですか？（1）標準 PAYG キー（2）Token Plan キー（3）今はスキップして、おすすめを確認するだけ」と尋ね、選択に基づいて進めてください

Windows：python3 が利用できない場合は、python を使用してください。または、スニペットを一時的な .py ファイルに保存して実行してください。

データの解決順序

ユーザーの質問に適したデータソースを選んでください。上位の段階にある復旧手順を試す前に、下位の段階へフォールバックしないでください。

質問の種類	主なデータソース	備考
一般的な案内、または特定時点のモデル詳細	CDN の推奨情報とドメイン別カタログ	まず取得してください。利用できない場合は、対応するローカルの代替データを使用し、スナップショットであることを明示してください
最新／正確／具体的な情報（価格、モデルの詳細、クォータ）	CLI を必ず使用してください — cli-usage.md を参照	スナップショットは古いため、数値を捏造しないでください
機能による検索（「X を実行できるモデル」）	qwencloud models search "<X>" --format json	スナップショットのキーワード網羅性は不完全です
CLI がエラーを返した	error-handling.md の復旧手順を実行し、その後に再試行	認証エラーの場合は 3 ステップのログインを実行し、スナップショットへスキップしないでください
CLI が完全に利用できず、ユーザーがインストール／ログインを拒否した場合	CDN カタログと pricing.md	スナップショットで裏付けられる情報のみ回答し、データが古い可能性があることを注記してください
上記すべてでは回答できず、ユーザーがオンライン検索を確認した場合	sources.md の URL	自発的に取得しないでください

診断フロー（対話型アドバイザリー）

ユーザーに次の順で質問します。

1. コンテンツの種類は？ — テキスト / 画像 / 動画 / 音声 / ビジョン
2. 主なタスクは？ — 生成 / 理解 / コーディング / 推論 / 翻訳
3. 優先事項は？ — 品質 / 速度 / コスト
4. 入力サイズは？ — 短い / 中程度 / 長いコンテキスト
5. 構造化出力は必要ですか？ — JSON / 関数呼び出しが必要か

デフォルトの推奨事項

デフォルトを選択する前、またはモデルを推奨する前に、最新の CDN 推奨事項を取得して読みます。 Token Plan キーの場合は、上記でリンクされている Token Plan カタログも読み、候補をそのカタログ内に限定します。

• ユーザーがモデルを明示的に指定した場合は、そのモデルを維持し、実際に利用できない場合のみ報告します。
• それ以外の場合は、まず最も強いタスクのシグナルに合わせ、そのうえで適切な品質、速度、またはコストのティアを選択します。
• ユーザーが明示的に変更を求めない限り、選択したモデルに記載されている思考のデフォルト設定を維持します。
• CDN にアクセスできない場合は、ローカルの推奨事項を使用します。

縮退動作：このスキルが読み込まれていない場合、各実行スキルは CDN からデフォルト設定を読み込み、取得できない場合はバンドルされた設定にフォールバックします。このプロトコルはあくまで補助的なものであり、実行を妨げることはありません。

CLI クイックリファレンス

認証が必要です。 すべての models コマンドと usage コマンドには、有効な CLI セッション（ブラウザのデバイスフローログイン — API キーではありません）が必要です。コマンドが Not authenticated / AUTH_REQUIRED を返した場合：

1. cli-usage.md にある3 ステップのデバイスフローログインを実行します（OS に適したコマンドを使って認証 URL を先に開き、すぐにポーリングします）。
2. success の後、元のコマンドを再試行します。
3. ユーザーに $DASHSCOPE_API_KEY / $QWEN_API_KEY を尋ねることは絶対にしないでください。これらはモデル API の呼び出し用であり、CLI セッション用ではありません。上記のセキュリティと認証情報モデルを参照してください。
4. スナップショットに暗黙的にフォールバックすることは絶対にしないでください。

必要な情報	コマンド
モデルカタログ全体	qwencloud models list --all --format json
モダリティで絞り込む	qwencloud models list --input image --output text --format json
単一モデルの詳細	qwencloud models info <model-id> --format json
キーワード検索	qwencloud models search "<query>" --format json
無料ティアの残量	qwencloud usage free-tier --format json
認証状態	qwencloud auth status --format json

表示ルール：--format json の出力を解析し、人が読める要約を提示します。生の JSON をそのまま出力してはいけません。--format text の出力はそのまま表示し、その後に --- を付けて分析を追加します。詳細は cli-usage.mdを参照してください。

CLI のエラー処理 — クイックガイド

CLI が失敗した場合は、まず分類し、復旧してから再試行してください。スナップショットへのフォールバックを黙って行ってはいけません。

カテゴリー	復旧方法（概要）
auth-failure	3 ステップのログインを実行 → 元のコマンドを再試行。ユーザーが拒否した場合にのみフォールバックします。
not-installed	インストールコマンドを提示 → ユーザーにインストールを依頼 → 再試行します。スナップショットを黙って使用してはいけません。
model-not-found	qwencloud models search "<keyword>" を実行 → 上位 3 件を提案 → 正しい ID で再試行します。
network-timeout	2 秒後に 1 回再試行し、2 回目も失敗した場合にのみフォールバックするかどうかを尋ねます。
rate-limit	Rate Limit Console を表示し、ユーザーに判断してもらいます。
quota-exhausted	Billing Console を表示します。スナップショットを使用してはいけません。
version-mismatch	qwencloud version --check または更新確認スキルを提案 → アップグレード → 再試行します。
other	標準エラー出力をそのまま表示し、ドキュメントへのリンクを提示します。ユーザーがオプトアウトした後にのみフォールバックします。

分類の詳細、シグナル、フローの例については、error-handling.md を参照してください。

料金とコストの見積もり

• 最新の料金：まず qwencloud models info <model> --format json を実行してください。pricing.md に記載された CDN 料金リファレンスは、フォールバックとしてのみ使用します。料金を捏造してはいけません。
• 必須の免責事項：コストに関するすべての回答は、pricing-disclaimer.md に記載された免責事項で必ず締めくくってください（ユーザーの回答言語に合わせて中国語版または英語版を使用します）。免責事項を省略することは重大な失敗です。
• 無料枠：無料枠が利用可能だと決めつけてはいけません。qwencloud usage free-tier で確認するか、ユーザーをコンソールに案内してください。
• 使用状況／請求に関する問い合わせ：該当するコンソールページに案内してください。pricing-disclaimer.md の表を参照してください。

更新の確認

ユーザーが更新の確認（「更新を確認」「バージョンを確認」「新しいバージョンはありますか」「スキルを更新」）を依頼した場合：

1. qwencloud-update-check を探す：同階層のスキルディレクトリにある qwencloud-update-check/SKILL.md を探します。
2. 見つかった場合 — 次を実行し、結果を報告します：python3 <qwencloud-update-check-dir>/scripts/check_update.py --print-response。ユーザーが強制確認を依頼した場合は --force を使用します。
3. 見つからない場合 — qwencloud version --check を実行し、結果を報告します。

アンチパターン

• ユーザーが指定したモデルを決して変更しないでください — ユーザーが明示的にモデルを選択した場合、そのリクエストでは別のモデルを提案せず、利用可能かどうかだけを確認してください。提案してよいのは、ユーザーが提案を求めた場合、または選択したモデルが実際に利用できない場合のみです（その場合も、最終的に決めるのはユーザーです）。
• モデル名を決して捏造しないでください — CDN カタログに掲載されているモデル、または CLI が返したモデルのみを提案してください。
• ユーザーの課金範囲外のモデルを決して提案しないでください — Token Plan キーには、上記にリンクされている Token Plan カタログのモデルのみを提示してください。PAYG キーでは全カタログを利用できます。これに違反すると、ユーザーに重大なエラーが発生します。
• 価格を決して捏造したり、推測したりしないでください — CLI、pricing.md、公式料金ページのみを参照してください。価格の捏造は重大な失敗です。
• CLI でエラーが発生しても、黙ってスナップショットに切り替えないでください — まず error-handling.md の復旧手順を適用してください。
• 無料利用枠が使えると決めつけないでください — 利用枠は消費済み、期限切れ、または削除済みの場合があります。必ず有料の単価を先に提示してください。
• API キーを平文で決して出力しないでください —「セキュリティ」セクションを参照してください。
• CLI のセッションと API キーを決して混同しないでください — CLI の認証ではブラウザーのデバイスフローログインを使用します。CLI の Not authenticated / AUTH_REQUIRED エラーの解決策として、$DASHSCOPE_API_KEY や $QWEN_API_KEY を決して提示しないでください。
• 任意の URL を先回りして取得したり、ウェブ検索を実行したりしないでください。 モデルデータが必要な場合は、ドキュメントに記載された CDN モデルカタログを取得してください。その他のオンラインソースにアクセスしてよいのは、CLI と CDN カタログでは回答できず、かつユーザーの確認を得た場合のみです。
• 使用状況／課金／コンソールの URL を決して組み立てないでください — このスキルまたはその参照資料に記載された正確なリンクのみを使用してください。URL が記載されていない場合は、作成しないでください。
• 料金に関する回答では、必ず免責事項を含めてください（pricing-disclaimer.md を参照）。

参照資料

ソース	目的
cli-usage.md	CLI 優先の方針、3 ステップのログイン、表示ルール、モデル詳細 URL
error-handling.md	CLI エラーの分類と復旧
qwencloud-model-recommendations.md (CDN) (local fallback)	スキル横断の推奨事項、Token Plan、思考モード
pricing-disclaimer.md	料金のガイダンス＋必須の免責事項＋課金コンソールのリンク
pricing.md	安定した課金ガイダンスと CDN 料金情報のフォールバック
qwencloud-model-list.md (CDN) (local fallback)	ドメイン横断のモデルカタログスナップショット
sources.md	公式ドキュメントの URL
qwencloud models list --format json	動的：価格、機能、利用枠を含むモデルカタログ全体
qwencloud models info <id> --format json	動的：単一モデルの詳細（料金ティア、コンテキスト、レート制限）
qwencloud models search "<q>" --format json	動的：キーワードによるモデル検索
qwencloud usage free-tier --format json	動的：モデルごとの無料利用枠の残量