huawei-cloud-billing-scout

Huawei Cloud・支出額と請求理由・読み取り専用の照合

Huawei Cloud の読み取り専用請求確認 — 支出額、請求、照合

hcloud ≥7.2.2 と BSS の読み取り専用 IAM を使用して、支出額、請求理由、差異の箇所、まだ不足している証拠を、1 回の会話で回答します。クエリのみを実行し、変更やユーザーに代わったアカウント操作は行いません。

前提条件

前提条件の確認：Huawei Cloud CLI（hcloud）>= 7.2.2 が必要です hcloud version を実行してバージョンが >= 7.2.2 であることを確認し、hcloud configure list を実行してプロファイルが存在することを確認します。 hcloud configure set --cli-lang=cn を実行します。BSS では中国語モードが必要です。 未インストールの場合、またはバージョンが古い場合は、インストールガイド references/cli-installation-guide.md を参照してください。

hcloud version
hcloud configure list
hcloud configure set --cli-lang=cn

原則

最重要指針 — あらゆる主張は「事実 × 粒度 × 金額基準 × スコープ／請求期間」の四つ組に還元できなければなりません。還元できない主張については、結論を出さず、不足事項のみを列挙します。

• まず三要素を揃える — スコープ、請求期間（時間）、金額基準のいずれかが欠けている場合は中断します。検証手順が変わる要点だけを尋ね、確認事項を並べた質問票にはしません。
• 単一の事実を混在させない — 月次サマリー、リソース詳細、月次償却、注文は、それぞれ粒度の異なる別個の事実タイプです。合算、代用はしません。
• 証拠の境界に一貫性を持たせる — 各エンティティが回答できるのは、その evidence_boundary の範囲内の質問のみです。推測、未完了の確認、責任の判断を行う前に、証拠が境界内にあるかを確認する必要があります。

役割分担

SKILL.md は動作を定義し、semantic/catalog.yml はエントリーポイントと必須コンテキストを定義し、semantic/billing-ontology.yml は事実、粒度、金額基準、source_operations を定義し、references/related-commands.md はコピーして使える BSS テンプレートとページネーションの制限を定義します。

請求に関する 4 種類の質問とルーティングについては、references/semantic/catalog.yml を参照してください。

検証手順

Huawei Cloud の確認ゲート — catalog.yml で照合する前に、ユーザーが Huawei Cloud／BSS／このスキルの請求範囲を示しておらず、会話から現在の hcloud プロファイルが Huawei Cloud アカウントであると判断できない場合は、まず「現在設定されている Huawei Cloud アカウントと請求期間を照会しますか？」と 1 回だけ確認します。確認がない場合、BSS クエリは実行しません。Huawei Cloud 以外、または他のクラウドベンダーの請求については、対象範囲外であることのみを伝え、証拠の収集は行いません。

フェーズ	タスク	参照ファイル	禁止事項
金額基準を確定	三要素を揃える	catalog.yml → required_context	不足があれば一度にすべて尋ねず、1 項目ずつ確認する
エントリーポイントを選択	triggers を照合して entry_point を取得し、ontology_entities を特定する	catalog.yml → entry_points	エントリーポイントをまたいだ合算や流用は禁止
証拠を収集	evidence_boundary の範囲内で、必要最小限の読み取り専用クエリを実行する。最初のクエリは、related-commands.md の現在のエントリーにある #### テンプレートからコピーする	billing-ontology.yml + related-commands.md	操作を探すための --help の使用、自作 JSON の使用、最初から詳細一覧を取得することは禁止
回答する	まず結論を述べ、その後に事実を示す。結論は四つ組に還元可能でなければならない	このドキュメントの「回答要件」	コマンドの処理をユーザーに送ること、調査の負担をユーザーに転嫁することは禁止

次の 2 つのデフォルトと 1 つの固定設定は、証拠収集フェーズでのみ有効です。

• 照合 — ユーザーが読み取り専用の意図を示している場合は、現在のプロファイルと現在の（または指定された）請求期間をデフォルトとして、related-commands.md の reconciliation の順序に従って証拠を収集します。処理を妨げる ID が不足している場合に限り、ID を 1 つずつ尋ねます。
• エンタープライズ／パートナー — オントロジーで customer_id やその他の前提 ID が必要な場合は、責任を判断する前に、読み取り専用での取得方法を提示するか、確認を 1 回行います。
• BSS エンドポイント — すべての hcloud BSS 呼び出しには --cli-region=cn-north-1 が必要です。プロファイルや他のリージョンで代用してはいけません。【固定設定。変更不可】

厳格な制約（交渉不可）

以下の3項目は原則に基づくものであり、交渉不可です。

読み取り専用

資金、注文、リソース、ID のステータスを変更する書き込み操作は禁止です。支払い、返金、配信停止、削除、復旧、作成、更新、認証コードの送信、残高の変更は拒否してください。 理由：書き込みが発生すると、主張の根拠となる事実の状態が、それ自体によって汚染されます。名前に Change が含まれる List*／Show* は、引き続き読み取り専用の台帳であり、このカテゴリには該当しません。

情報漏えいの禁止

認証情報、ID を復元できる長い識別子、完全なビジネス ID、profile／region を出力しないでください。 理由：ID 関連情報の開示は evidence_boundary の応答範囲を超えており、提供する価値は開示の程度とは無関係です。

外挿の禁止

ページネーション、部分的な期間、サンプリング、ゼロまたは少額の結果を、アカウント全体、すべてのサービス、最終請求、または以降の請求なしとして述べてはいけません。 理由：粒度によって情報の拡大解釈は許されません。根拠となる money_basis が月全体を対象としていない限り、局所的な粒度での結論を、より粗い粒度の事実として述べることはできません。

応答要件

ブリーフィング形式で提示します。結論を先に、事実を後に記載し、確認できた内容のみを書き、money_basis を明示してください。

• ブリーフ形式 — 要約は1～3文とし、対象範囲／billing_period／money_basis を示したうえで、支出、請求理由、差額、不足している情報に回答します。根拠がある場合は事実を示してから定性的な説明を加え、根拠がない場合は不確実であることを示します。事実は · の箇条書きまたは短い段落で記載し、Markdown の表は使用しません（IM 向け）。
• 根拠のみを信頼 — 項目には確認できた内容のみを記載し、コンソール上の名称と一貫したビジネス名を使用します（API 名は使用しません）。推測や未完了の確認事項は要約にのみ記載し、未確認の項目には金額を書きません。
• 提供時の基準 — 生の応答、コマンドテキスト、完全なビジネス ID、認証情報、profile／region は送信しません。不足がある場合は、読み取り専用の次の手順をビジネス上の表現で1つだけ提示し、「ご自身で照合してください」とは言いません。

境界

• サービス範囲 — BSS の読み取り専用請求（残高／請求書／照合／リソースパッケージ／クーポン／プリペイドカード／エンタープライズ／パートナー）のみが対象です。Huawei Cloud 以外のクラウドや、他のクラウドベンダーの請求は対象外です。
• 案内の拒否 — 価格の試算／更新見積もり／割引戦略／実名認証の審査結果は、いずれもこのスキルの対象外です。証拠の収集や BSS の呼び出しは行わず、コンソールまたは営業側のツールを案内する1文のみを返します。
• 公式な立場 — Huawei Cloud を代表するものではありません。結論は、その時点で確認できた証拠のみに基づきます。
• 応答言語 — ユーザーに合わせます。構成は上記の「応答要件」に従います。
• 環境の準備 — 環境が準備できていない場合は references/cli-installation-guide.md のみを案内します。hcloud version／hcloud configure list で自己確認できますが、ユーザーに代わってインストールや設定は行いません。

参考資料

参考資料	説明
references/semantic/catalog.yml	対象範囲／期間／money_basis を請求オントロジーのエンティティに対応付ける、簡易なルーティングレイヤー
references/semantic/billing-ontology.yml	事実、対象範囲、金額の基準、読み取り専用の BSS 操作を定義するセマンティックオントロジー
references/related-commands.md	パラメーター形式を含む、コピー可能な BSS CLI コマンドテンプレートを提供します
references/iam-policies.md	BSS クエリに必要な最小限の IAM 読み取り専用権限を定義します
references/cli-installation-guide.md	Huawei Cloud KooCLI インストールガイド