qwencloud-usage について
QwenCloudアカウントの使用量、請求、認証、サブスクリプション、注文、席数、クォータ、支出上限を照会・解釈するスキルです。CLI利用前に参照資料を確認し、定められた形式でデータを提示します。
主な機能
- 01使用量とクォータの照会
- 02請求と支出上限の確認
- 03サブスクリプション、注文、席数の確認
- 04認証イベントの確認
- 05出力形式とデータ整合性の規則適用
活用シーン
- 01アカウント使用量と無料枠の確認
- 02請求期間の費用把握
- 03契約または席数の状態確認
- 04IDによるAPIリクエスト検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ qwencloud/ qwencloud-ai --skill qwencloud-usageインストール後、Claude Code で/qwencloud-usageを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/authentication.mdbilling.mdcli.mdsubscriptions.mdusage.md詳細
QwenCloud の使用状況
アカウント認証、使用状況、請求、呼び出しログ、クォータ、サブスクリプション、注文、シート、および PAYG の利用上限にこのスキルを使用します。アカウントデータを捏造したり、模擬したりしないでください。
ワークフロー
- 何かを実行する前に、references/cli.md を読みます。インストール、認証フロー、コマンド、引数、ページネーション、出力モード、終了処理に関する唯一の情報源です。
- リクエストに関連する結果の意味を説明するリファレンスのみを読みます。
- 使用状況の概要、無料枠、PAYG、モデル別内訳、またはリクエストログ:references/usage.md
- 請求サイクル、コスト内訳、または利用上限:references/billing.md
- サブスクリプションのステータス、注文、またはシート:references/subscriptions.md
- ログイン、ログアウト、認証情報の期限切れ、または認証イベント:references/authentication.md
- 特定の requestId を検索する場合は、
--from、--to、--periodを追加せず、日付をユーザーに尋ねずに直接検索します。時間フィルターを追加するのはユーザーが明示的に指定した場合のみです。references/cli.md を参照してください。 - 以下の出力仕様に従って結果を解釈し、表示します。
出力仕様
形式と表示
CLI リファレンスの出力モードに関するルールに従います。ユーザーの質問に関連する、人が読める情報のみを提示し、任意の分析は結果の後に記載します。
ユーザー向けの出力に Coding Plan を表示しないでください。CLI から返された場合でも、「未購読」のプレースホルダーを含め、coding_plan、codingPlanStatus およびその子フィールドは省略します。
結果のルール
- 結果を
success、partial、empty、confirmation_required、errorのいずれかに分類します。 - top-N の上限によって行が省略されている場合、ページネーションが未完了の場合、または CLI リファレンスの整合性チェックに失敗した場合は、
partialを使用します。データが完全であるかのように示してはいけません。 - Free Tier について、ユーザーがすべてのクォータを尋ねた場合は、返されたモデルをすべて表示します。回答に一部のモデルしか表示されていない場合は、表示数と総数を明記し、結果を
partialとして分類し、すべての Free Tier クォータを表示するための references/cli.md に記載された完全なコマンドを含めます。さらに表示できると申し出るだけでは不十分です。 - 対応する 2 つのコマンドが、同じレコードに見えるものについて相反する値を返した場合は、各値の出典と対象範囲を示し、結果を
partialとして分類します。どちらかを黙って選んだり、統合したり、整合させるための情報を捏造したりしてはいけません。
請求とサブスクリプションのデータ
- 操作から返された通貨を使用し、換算してはいけません。請求サイクルの概要に限り、
pretaxAmount、tax、aftertaxAmountの値を表示します。 - コスト内訳では、返された
rows[].amount、該当するフラットレスポンスまたはスライスレベルのtotalAmount、およびcurrencyのみを表示します。サブスクリプションのステータスまたは注文では、実際に存在する金額フィールドと通貨フィールドのみを表示します。返されていない税抜額、税額、税込額、または通貨フィールドを補ってはいけません。 - コスト内訳では、モデルランキングから
groupKey=__tax__を除外し、その行の返された金額を税額として別に表示します。 - 利用可能な Team シート数は
seatSummary.groups[]のみから算出します。各グループについてmax(seats - assigned, 0)を使い、その合計を求めます。過去のシートインスタンス一覧から現在の上限を推定してはいけません。 - 返された日付や金額を再計算してはいけません。レスポンスを検証し、上記の表示ルールを適用します。
- 請求またはサブスクリプションのデータを提示する場合は、必ず次の文を末尾に追加します。“最終金額はコンソールの請求明細に基づきます。”
製品の仕様
- Token Plan のクォータと残高は、10 進数の Credits を使用します。残りの Credits と合計 Credits は、数値または数値文字列としてエンコードされているかどうかにかかわらず、JSON で返される精度を完全に保持してください。丸めたり、切り捨てたり、省略表記にしたりしないでください。たとえば、
63028.84805624は63,029ではなく、63028.84805624と表示します。これは使用状況の概要、サブスクリプションクォータ、ティア、シート、クレジットパックに適用されます。モデルごとの Credit 内訳はありません。 - 消費量を比較するときは、同じクォータ範囲から取得した正確な値を使用してください。丸められた使用率がゼロでも、Credits が消費されていない証拠にはなりません。丸められた表示から、未使用かどうかや返金の対象かどうかを推測しないでください。
- Coding Plan は、
per_5h、weekly、monthlyの期間におけるリクエストの合計数を使用し、モデルごとの内訳はありません。未登録の場合、そのブランチは{ "subscribed": false }です。 - PAYG で公開されるのは使用量の合計のみで、入力と出力の内訳はありません。
- モデルごとの内訳があるのは PAYG のみです。内訳がゼロまたは空でも、Free Tier、Token Plan、Coding Plan の消費状況はわかりません。
- 使用状況の概要には
period: { from, to }があり、次の製品ブランチが含まれます。free_tier[]:model_idと、quota: nullまたはquota: { remaining, total, unit, used_pct, status, resetDate }のいずれかが含まれます。利用可能で、利用可能クォータの合計に含めてよいのはstatus=validのみです。remainingが正の値でも、expireは期限切れ、exhaustは使い切ったものとして扱います。不明なステータスまたはquota: nullの場合、利用可能かどうかは不明です。token_plan:登録済みの場合、subscribed、planName、status、totalCredits、remainingCredits、usedPct、resetDateが含まれます。それ以外の場合、少なくとも{ "subscribed": false }が含まれます。resetDateは、値がある場合、次回のクレジット更新日です。値がない場合、更新日は不明として報告してください。サブスクリプションの自動更新がオフの場合は、この日付をもってプランの有効期限が切れることを明記してください。coding_plan:登録済みの場合、subscribed、plan、およびper_5h、weekly、monthlyを含むwindowsが含まれ、それぞれにremaining、total、used_pctが含まれます。それ以外の場合は{ "subscribed": false }です。pay_as_you_go:model_id、usage、cost、currencyを含むmodels[]エントリーと、total: { cost, currency }が含まれます。
コメント
Markdown 対応