alibabacloud-domain-manage

ドメインクエリスキル

Alibaba Cloud のプロフェッショナルなドメインクエリアシスタントです。ドメインの詳細、ドメイン一覧、高度なフィルター検索、インスタンス ID による検索など、ドメイン情報の照会を支援します。すべての操作は読み取り専用であり、ユーザーの確認は不要です。

シナリオの説明

このスキルでは、次のドメイン情報の照会シナリオに対応します。

アーキテクチャ：Alibaba Cloud Domain Service (Global) + Aliyun CLI Plugin

ユーザーの意図	API コマンド	要点
特定のドメインの詳細を照会する	query-domain-by-domain-name	正確なドメイン名が必要です
インスタンス ID でドメインを照会する	query-domain-by-instance-id	インスタンス ID が必要です（例：S2024...）
アカウント配下のすべてのドメインを一覧表示する	query-domain-list	ページネーション、あいまい検索、並べ替えに対応しています
高度なフィルターでドメインを検索する	query-advanced-domain-list	ステータス、有効期限の範囲、ドメインタイプ、サフィックス

意図の振り分け：

ユーザー入力のパターン	振り分け先
特定のドメイン名を含む（例：example.com）	query-domain-by-domain-name
インスタンス ID を含む（例：S2024...）	query-domain-by-instance-id
「すべてのドメイン」／「自分のドメイン」／「ドメイン一覧」	query-domain-list
フィルター条件（ステータス、有効期限、タイプ）を含む	query-advanced-domain-list
あいまい	ユーザーに確認します

事前チェックリスト

事前チェック：Aliyun CLI >= 3.3.3 が必要です

aliyun version を実行し、>= 3.3.3 であることを確認してください。インストールされていない場合、またはバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行してインストール／更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。

事前チェック：Aliyun CLI プラグインの更新が必要です

[MUST] aliyun configure set --auto-plugin-install true を実行し、自動プラグインインストールを有効にしてください。 [MUST] aliyun plugin update を実行し、既存のプラグインが常に最新であることを確認してください。

コアワークフローの開始時（CLI を呼び出す前）： [MUST] AI モードを有効にする — エージェントスキルの実行と API 呼び出しの追跡には AI モードが必要です。 手順 1：CLI を呼び出す前に、次のコマンドを実行してください。

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-domain-manage"

手順 2：次を実行して、AI モードが有効であることを**[MUST] 確認**してください。

aliyun configure ai-mode status

出力で AI モードが有効であることを確認できない場合は、停止して手順 1 を再試行してください。AI モードが有効であることを確認するまで、ドメイン API を呼び出さないでください。

[MUST] すべての終了時に AI モードを無効にする — どのような理由であっても、最終応答を返す前に必ず AI モードを無効にしてください。これは、ワークフローの成功、ワークフローの失敗、エラー／例外、ユーザーによるキャンセル、セッション終了、その他 CLI コマンドを実行しない状況を含む、すべての終了経路に適用されます。

aliyun configure ai-mode disable

事前チェック：Alibaba Cloud の認証情報が必要です

セキュリティルール：

• AK/SK の値を読み取ったり、エコーしたり、表示したりすることは絶対にしないでください（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止です）
• 会話中またはコマンドラインで AK/SK を直接入力するようユーザーに求めることは絶対にしないでください
• リテラルの認証情報を指定して aliyun configure set を使用することは絶対にしないでください
• 認証情報の状態確認には aliyun configure list のみを使用してください

aliyun configure list

有効なプロファイル（AK、STS、または OAuth ID）があることを出力で確認してください。

有効なプロファイルがない場合は、ここで停止してください。

1. Alibaba Cloud Console から認証情報を取得します
2. このセッションの外部で認証情報を設定します（ターミナルで aliyun configure を実行するか、シェルプロファイルで環境変数を設定します）
3. aliyun configure list に有効なプロファイルが表示された後、戻って再実行します

[MUST] 事前確認の手順（順番に実行し、手順を省略しないでください）：

1. aliyun version を実行 → 出力が >= 3.3.3 であることを確認します。そうでない場合は CLI をインストール／更新します。
2. aliyun configure set --auto-plugin-install true を実行します
3. aliyun plugin update を実行します
4. aliyun configure ai-mode enable を実行します
5. aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-domain-manage" を実行します
6. aliyun configure ai-mode status を実行 → AI モードが有効であることを確認します。有効でない場合は、手順 4～5 を繰り返します。
7. aliyun configure list を実行 → 有効なプロファイルがあることを確認します。ない場合は停止します。

[MUST] 各手順は個別のコマンドとして実行してください。手順をまとめたり、省略したりしないでください。7 つすべての手順が正常に完了したことを確認するまで、コアワークフローに進まないでください。

[MUST] 各ドメイン API コマンドの実行前に確認してください：

• AK/SK の値を読み取ったり、エコーしたりしていない
• コマンドでプロダクトコードとして小文字の domain を使用している
• コマンドでアクションとパラメーターにケバブケースを使用している
• コマンドに --api-version 2018-01-29 が含まれている
• コマンドに --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage が含まれている
• コマンドに --region-id が含まれていない（domain はグローバルサービスです）
• このセッションで AI モードが有効であることを確認済みである（上記の手順 6）

CLI コマンドの規則

[MUST] CLI を呼び出す前に毎回 references/related-commands.md を読み、正確な構文とパラメーターの詳細を確認してください。

規則	正しい例	誤った例
製品コード	domain	Domain
アクション形式	query-domain-list	QueryDomainList
パラメーター形式	--domain-name	--DomainName
User-Agent	--user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage	省略
リージョン	--region-id なし	--region-id cn-hangzhou
配列パラメーター	.1 .2 の接尾辞	JSON 配列
API バージョン	--api-version 2018-01-29	省略または誤ったバージョン

必要な権限

ポリシーの全容は references/ram-policies.md を参照してください。主な権限は次のとおりです。

カテゴリー	RAM アクション
クエリ	QueryDomainList、QueryAdvancedDomainList、QueryDomainByDomainName、QueryDomainByInstanceId

[MUST] 権限エラーへの対応： 実行中のいずれかの時点で、コマンドまたは API 呼び出しが権限エラーにより失敗した場合は、次の手順に従ってください。

1. references/ram-policies.md を読み、この SKILL に必要な権限の全一覧を確認します
2. 必要な権限を申請する手順をユーザーに案内します
3. 必要な権限が付与されたことをユーザーが確認するまで待機します

禁止されている操作

重要：次の操作は絶対に行わないでください。

1. 絶対に AK/SK の値を読み取ったり、エコーしたり、表示したりしないでください（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止です）
2. 絶対に会話中に AK/SK を直接入力するようユーザーに求めないでください
3. 絶対にリテラルの認証情報を指定して aliyun configure set を使用しないでください
4. 絶対に --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage を指定せずにコマンドを実行しないでください
5. 絶対に --region-id を渡さないでください。ドメイン API はグローバルサービスです
6. 絶対に非推奨の API 形式（PascalCase）を使用しないでください。必ずプラグイン形式（kebab-case）を使用してください
7. 絶対に出力を捏造したり推測したりしないでください。すべてのデータは実際の API 結果に基づいている必要があります
8. 絶対に書き込み操作（更新、復元、ロック、変更）を実行しないでください。このスキルは読み取り専用です

パラメーターの確認

リスクレベル	操作	確認
なし	このスキルのすべてのクエリ操作	確認不要

このスキルのすべての操作は読み取り専用です。実行前にユーザーの確認は不要です。

基本的なワークフロー

シナリオ 1：ドメイン名でドメインの詳細を照会

User: "查一下 example.com 的信息" / "Show info for example.com"
  ↓
[1] Pre-flight Steps → all 7 steps confirmed successful
  ↓
[2] [GUARD] Confirm 'aliyun configure ai-mode status' returned enabled in this session. If not, go back and enable AI-mode first.
  ↓
[3] aliyun domain query-domain-by-domain-name --api-version 2018-01-29 --domain-name "example.com" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage
  ↓
[4] Format and display key fields (see references/related-commands.md § Display Format)
  ↓
[5] Output Validation: verify all displayed fields come from actual API response

シナリオ 2：インスタンス ID でドメインの詳細を照会

User: "查一下实例ID S20241234567890 对应的域名"
  ↓
[1] Pre-flight Steps → all 7 steps confirmed successful
  ↓
[2] [GUARD] Confirm 'aliyun configure ai-mode status' returned enabled in this session. If not, go back and enable AI-mode first.
  ↓
[3] aliyun domain query-domain-by-instance-id --api-version 2018-01-29 --instance-id "S20241234567890" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage
  ↓
[4] Format and display (same fields as Scenario 1)
  ↓
[5] Output Validation: verify all displayed fields come from actual API response

シナリオ 3：ドメイン一覧を照会

User: "查看我所有的域名" / "Show all my domains"
  ↓
[1] Pre-flight Steps → all 7 steps confirmed successful
  ↓
[2] [GUARD] Confirm 'aliyun configure ai-mode status' returned enabled in this session. If not, go back and enable AI-mode first.
  ↓
[3] aliyun domain query-domain-list --api-version 2018-01-29 --page-num 1 --page-size 20 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage
  ↓
[4] Display domain list with pagination info (TotalItemNum, CurrentPageNum, TotalPageNum)
  ↓
[5] If TotalPageNum > CurrentPageNum, inform user about remaining pages and offer to query next page
  ↓
[6] Output Validation: displayed count matches TotalItemNum from API response

任意のフィルターと並べ替えパラメーターについては、references/related-commands.md § query-domain-list を参照してください

シナリオ 4：ドメインの詳細検索

User: "查看即将过期的域名" / "查看所有正常状态的域名"
  ↓
[1] Pre-flight Steps → all 7 steps confirmed successful
  ↓
[2] Parse user intent → map to query-advanced-domain-list parameters
    (see references/related-commands.md § User Intent Mapping & Domain Status Codes)
  ↓
[3] [GUARD] Confirm 'aliyun configure ai-mode status' returned enabled in this session. If not, go back and enable AI-mode first.
  ↓
[4] aliyun domain query-advanced-domain-list --api-version 2018-01-29 --page-num 1 --page-size 20 [filters] --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage
  ↓
[5] Display results with pagination handling (same as Scenario 3)
  ↓
[6] Output Validation: displayed count matches TotalItemNum, filter conditions reflected in output

ベストプラクティス

1. すべての呼び出しで --user-agent を指定 — すべての aliyun domain コマンドに --user-agent AlibabaCloud-Agent-Skills/alibabacloud-domain-manage を指定する必要があります。
2. CLI 呼び出しの前に毎回 references/related-commands.md を読む — 正確なパラメーター名、型、有効な値を必ず確認してください。
3. フィルターを使った検索では query-advanced-domain-list を使用 — ユーザーがステータス、有効期限、ドメインの種類、またはサフィックスで絞り込みたい場合は、常にクライアント側のフィルタリングより query-advanced-domain-list を優先してください。
4. ページネーションに注意 — TotalPageNum と CurrentPageNum を必ず確認してください。残りのページについては、先回りしてユーザーに伝えてください。
5. タイムスタンプはミリ秒単位 — query-advanced-domain-list の日付フィルターでは、値はエポックからのミリ秒で指定する必要があります。
6. 読み取り専用ポリシーを優先 — 必要最小限の権限として、AliyunDomainReadOnlyAccess システムポリシーを使用するようユーザーに案内してください。
7. 捏造しない — 表示するすべてのフィールドは、実際の API レスポンスに基づいている必要があります。
8. 終了時に AI モードを無効化 — 終了前に必ず aliyun configure ai-mode disable を実行してください。

エラー処理

エラー	原因	解決方法
Forbidden.RAM	権限が不足しています	references/ram-policies.md を参照してください
DomainNotExist	このアカウントにドメインがありません	ドメイン名とアカウントを確認してください
InvalidAccessKeyId.NotFound	AccessKey が無効です	RAM Console を案内してください
SignatureDoesNotMatch	AK/SK が一致しません	aliyun configure の実行を案内してください
Throttling.User	レート制限を超過しました	1 秒待ってから、最大 3 回まで再試行してください

制限事項

このスキルでは、以下の操作はできません：

1. 書き込み操作（更新、引き換え、ロック／ロック解除、連絡先の変更、移管）の実行
2. 新規ドメインの登録または購入
3. DNS レコードまたは DNSSEC の管理
4. ドメイン情報テンプレートの作成または管理
5. タスクの実行履歴または監査ログの照会

これらの機能については、以下の スキル間の案内 を参照してください。

スキル間の案内

ユーザーの要望	推奨スキル
新しいドメインの登録	alibabacloud-domain-trade
ドメインの移管	alibabacloud-domain-trade
情報テンプレートの作成／管理	alibabacloud-domain-certification
DNS／DNSSEC の管理	alibabacloud-domain-dns
タスク履歴の表示	alibabacloud-domain-audit

ユーザーの依頼が照会機能の範囲を超える場合は、適切なスキルを案内してください。

クリーンアップ

このスキルは読み取り専用の操作を行い、リソースを作成しません。クリーンアップは不要です。

参考リンク

ドキュメント	説明
関連コマンド	CLI コマンド、パラメーター、応答フィールド、表示形式
RAM ポリシー	必要な権限とポリシーテンプレート
CLI インストールガイド	CLI のインストールと設定
認証情報の確認	認証情報の確認手順
検証方法	各シナリオの成功確認
受け入れ基準	テストと検証のチェックリスト

注意事項

1. このスキルのすべての操作は読み取り専用かつ同期的です。非同期タスクのポーリングは不要です。
2. query-domain-by-domain-name と query-domain-by-instance-id は同じ応答構造を返します。
3. query-advanced-domain-list のタイムスタンプパラメーターの値は、エポックからの経過時間を ミリ秒 で表します。