huawei-cloud-dds-dcs-instance-management

Huawei Cloud DDS および DCS 管理スキル

Huawei Cloud Document Database Service（DDS）と Distributed Cache Service（DCS）を統合管理するスキルです。インスタンスの照会、デプロイ分析、セキュリティ評価、ライフサイクル全体の管理に対応します。

---

ステップ 0：skill-quality-cli のインストール（冪等。すでにインストールされている場合はスキップ）

CLI は ~/.local/bin/ にインストールされますが、このディレクトリが $PATH に含まれていない場合があります（skill-quality-cli を直接実行すると終了コード 127 で失敗することがあります）。最初にパスをエクスポートしてからインストーラーを実行してください（今後のシェル用に、~/.bashrc / ~/.profile にもパスのエクスポートが保存されます）。

export PATH="$HOME/.local/bin:$PATH"
bash scripts/ensure_cli.sh

スクリプトは skill-quality-cli が使用可能かどうかを確認します（PATH を確認し、見つからない場合は絶対パス ~/.local/bin/skill-quality-cli を確認します）。使用できない場合は、スキルに同梱された CLI ソース（scripts/cli/cli_entry.py + scripts/cli/cli_reporting.py）をローカルラッパーとして ~/.local/bin/ にデプロイします。外部からのダウンロードや実行時の curl は不要です（SC2 サプライチェーン安全性に対応。同梱された 1.1.8 にバージョンを固定）。現在のセッション用に PATH を再エクスポートし、~/.bashrc / ~/.profile にも保存します。同梱ソースが見つからない場合は何も表示せずにスキップされ、業務フローを妨げることはありません。その後もコマンドを直接実行できない場合は、絶対パス ~/.local/bin/skill-quality-cli を呼び出してください。

概要

このスキルは、Huawei Cloud の 2 つのミドルウェアサービスを包括的に管理します。

サービス	エンジンタイプ	カテゴリ
DDS（Document Database Service）	DDS-Community、DDS-Enhanced	MongoDB 互換ドキュメント DB
DCS（Distributed Cache Service）	Redis、Memcached	インメモリーキャッシュ

機能一覧

#	アクション	サービス	モード	重要度
1	huawei_list_dds_instances	DDS	CLI	R3 照会
2	huawei_get_dds_instance	DDS	CLI	R3 照会
3	huawei_list_dcs_instances	DCS	CLI	R3 照会
4	huawei_get_dcs_nodes_information	DCS	SDK	R3 照会
5	huawei_list_dcs_custom_templates	DCS	SDK	R3 照会
6	huawei_analyze_dds_deployment	DDS	CLI	R3 分析
7	huawei_analyze_dcs_security	DCS	CLI+SDK	R3 分析
8	huawei_create_dds_instance	DDS	CLI	R2 管理
9	huawei_add_dds_readonly_node	DDS	CLI	R2 管理
10	huawei_add_dds_sharding_node	DDS	CLI	R2 管理
11	huawei_create_dds_backup	DDS	CLI	R2 管理
12	huawei_create_dcs_instance	DCS	SDK	R2 管理
13	huawei_create_dcs_custom_template	DCS	SDK	R2 管理
14	huawei_delete_dds_instance	DDS	CLI	R1 管理
15	huawei_delete_dcs_instance	DCS	CLI	R1 管理
16	huawei_restart_dcs_instance	DCS	CLI	R1 管理

アーキテクチャ

User Request → Action Router
  ├── DDS Actions → hcloud DDS CLI (primary) → SDK fallback
  └── DCS Actions → hcloud DCS CLI (primary) → SDK fallback (create_instance,
       show_nodes_information, list_config_templates, create_custom_template)
       → Result Formatting → Analysis & Recommendations

---

前提条件

要件	説明
hcloud CLI	インストール済みで、認証が完了していること。references/cli-installation-guide.md を参照してください
Python 3.8+	SDK による代替操作（DCS）に必要です
SDK パッケージ	pip install huaweicloudsdkdcs huaweicloudsdkdds
AK/SK 認証	HUAWEI_ACCESS_KEY/HUAWEI_SECRET_KEY または HWC_AK/HWC_SK 環境変数
IAM 権限	DDS および DCS の読み取り／書き込み権限。references/iam-policies.md を参照してください
デフォルトリージョン	cn-north-4（--cli-region で変更できます）

品質レポート用環境変数

変数	必須	説明
SKILL_QUALITY_ENDPOINT	いいえ	レポート送信先（デフォルト：skillsapi.developer.myhuaweicloud.com）
SKILL_QUALITY_DISABLE	いいえ	1 に設定すると無効になります（ローカルデバッグ用）
SKILL_QUALITY_REPORT	いいえ	v1.1.8 のオプトアウト：0 に設定するとレポートをスキップします（コマンドは引き続き実行されます）
SKILL_QUALITY_SESSION_ID	いいえ	セッション ID の上書き（v1.1.8 の 3 つの取得元：--session-id > 環境変数 > qcfg > ホスト）
SKILL_QUALITY_TIMEOUT	いいえ	タイムアウト秒数（デフォルト：3）

---

ワークフロー

コマンド記述規約（品質報告の迂回経路に関する補足）／コマンドの実行可能性に関する説明（評価／解析の要点）：この Skill のすべての CLI コマンドは、直接実行できる hcloud <Service> <Operation> --key=value ... 形式のネイティブコマンドとして記述されており、それぞれ単独で実行できます（評価パイプライン／パーサーはこの形式で抽出できます）。実行時には必要に応じて skill-quality-cli run --skill-name <skill-name> -- <hcloud 命令> でラップしてください。skill-quality-cli run は品質報告の迂回経路にすぎず（コマンドの前後にテレメトリーを挿入し、コマンドをそのまま渡します）、後続の hcloud コマンド自体の実行可能性には影響しません（hcloud <Operation> --help で実測して確認済みです）。コマンドの意味、パラメーター、戻り値は、直接実行した場合と完全に同一です。

クエリ（R3）— インスタンス一覧と詳細

# List DDS instances (all, with optional filters)
hcloud DDS ListInstances --cli-region={region}
hcloud DDS ListInstances --cli-region={region} --datastore_type=DDS-Community
hcloud DDS ListInstances --cli-region={region} --id={instance_id}  # single instance
# Filter by deployment mode. NOTE: `--mode` shares its name with a KooCLI system
# parameter, so KooCLI prompts for confirmation. Interactive: type `b` (target API
# parameter) when prompted. Non-interactive/scripted: pipe the answer (verified):
echo b | hcloud DDS ListInstances --cli-region={region} --mode=ReplicaSet
# KooCLI-recommended alternative for non-interactive environments: pass the
# parameter via a JSON input file (verified; note --project_id is required
# on the cli-jsonInput path):
#   echo '{"query": {"mode": "ReplicaSet"}}' > /tmp/dds_mode.json
#   hcloud DDS ListInstances --cli-region={region} --project_id={project_id} --cli-jsonInput=/tmp/dds_mode.json
# Alternative without the prompt: list all and filter by `mode` client-side.
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ListInstances --cli-region={region}

# List DCS instances
hcloud DCS ListInstances --cli-region={region}
hcloud DCS ListInstances --cli-region={region} --name={name}
hcloud DCS ListInstances --cli-region={region} --instance_id={id}
hcloud DCS ListInstances --cli-region={region} --status={status}
# Note: `capacity` is NOT a filter of DCS ListInstances — it is only a
# Create-time parameter. Filter the returned JSON by capacity client-side if needed.
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS ListInstances --cli-region={region}

クエリ（R3）— DCS ノード情報（SDK）

CLI を使用できない場合のフォールバック手段です。pip install huaweicloudsdkdcs が必要です。

# Service: DCS (huaweicloudsdkdcs.v2)
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2 import DcsClient
from huaweicloudsdkdcs.v2.model import ShowNodesInformationRequest
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion

creds = BasicCredentials().with_ak('{ak}').with_sk('{sk}')
client = DcsClient.new_builder() \
    .with_credentials(creds) \
    .with_region(DcsRegion.value_of('cn-north-4')) \
    .build()

request = ShowNodesInformationRequest(instance_id='{instance_id}')
response = client.show_nodes_information(request)
print(response)

クエリ（R3）— カスタムテンプレート一覧

# Service: DCS (huaweicloudsdkdcs.v2)
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2 import DcsClient
from huaweicloudsdkdcs.v2.model import ListConfigTemplatesRequest
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion

creds = BasicCredentials().with_ak('{ak}').with_sk('{sk}')
client = DcsClient.new_builder() \
    .with_credentials(creds) \
    .with_region(DcsRegion.value_of('cn-north-4')) \
    .build()

# `type` is required: 'user' for custom templates, 'sys' for system templates.
# `engine_version` and `cache_mode` are also required — omitting them returns
# DCS.4063 (missing required parameters).
request = ListConfigTemplatesRequest(
    type='user', engine='Redis', engine_version='5.0', cache_mode='single')
response = client.list_config_templates(request)
print(response)

分析（R3）— DDS デプロイメントの分析

複数のクエリを組み合わせて、デプロイメントアーキテクチャを評価します。

# Step 1: List all instances to understand topology
hcloud DDS ListInstances --cli-region={region} --limit=100

# Step 2: Check available flavors and storage types
hcloud DDS ListFlavors --cli-region={region} --engine_name=DDS-Community
hcloud DDS ListStorageType --cli-region={region}

# Step 3: For each instance, check config and backup policy
# `--entity_id` is required: pass the instance ID for replica set / single-node,
# or the group ID / node ID for cluster (sharding) instances.
hcloud DDS ShowEntityConfiguration --cli-region={region} --instance_id={id} --entity_id={entity_id}
hcloud DDS ShowBackupPolicy --cli-region={region} --instance_id={id}

# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ListInstances --cli-region={region} --limit=100
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ListFlavors --cli-region={region} --engine_name=DDS-Community
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ListStorageType --cli-region={region}
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ShowEntityConfiguration --cli-region={region} --instance_id={id} --entity_id={entity_id}
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS ShowBackupPolicy --cli-region={region} --instance_id={id}

分析（R3）— DCS セキュリティの分析

# Step 1: List instances to inventory
hcloud DCS ListInstances --cli-region={region}

# Step 2: Check IP whitelist per instance
hcloud DCS ShowIpWhitelist --cli-region={region} --instance_id={id}

# Step 3: Check instance details (security group, SSL)
hcloud DCS ShowInstance --cli-region={region} --instance_id={id}

# Step 4: Check ACL accounts
hcloud DCS ListAclAccounts --cli-region={region} --instance_id={id}

# Step 5: (SDK fallback) Inspect SSL/connection details via SDK — see the
# "DCS Node Information (SDK)" example below; replace the request with ShowInstanceRequest.

# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS ListInstances --cli-region={region}
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS ShowIpWhitelist --cli-region={region} --instance_id={id}
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS ShowInstance --cli-region={region} --instance_id={id}
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS ListAclAccounts --cli-region={region} --instance_id={id}

管理（R2）— DDS インスタンスの作成

⚠️ 請求対象のリソースを作成します。必ず事前にユーザーに確認してください。

# Replica set (3 nodes)
# NOTE: `--region` and `--vpc_id` are required body parameters of DDS CreateInstance — keep them.
# KooCLI prints a harmless "cli-region/region coexist" notice; that is expected.
# `--mode` also shares a name with a KooCLI system parameter — when prompted,
# answer `b` (target API parameter); in non-interactive envs use the `echo b |` prefix.
hcloud DDS CreateInstance --cli-region={region} \
  --name=my-dds --region={region} \
  --availability_zone={az} \
  --datastore.type=DDS-Community \
  --datastore.version=5.0 --datastore.storage_engine=wiredTiger \
  --mode=ReplicaSet \
  --flavor.1.type=replica --flavor.1.num=3 \
  --flavor.1.spec_code={spec_code} \
  --vpc_id={vpc_id} --subnet_id={subnet} --security_group_id={sg}
# Non-interactive prompt workaround (answer `b` to the `--mode` prompt):
#   echo b | hcloud DDS CreateInstance --cli-region={region} ... (same args)
#   echo b | hcloud DDS CreateInstance --cli-region={region} --name=my-dds --region={region} --availability_zone={az} --datastore.type=DDS-Community --datastore.version=5.0 --datastore.storage_engine=wiredTiger --mode=ReplicaSet --flavor.1.type=replica --flavor.1.num=3 --flavor.1.spec_code={spec_code} --vpc_id={vpc_id} --subnet_id={subnet} --security_group_id={sg}
# Fully non-interactive alternative (no prompts, recommended for CI/automation):
# NOTE: KooCLI 7.2.12 requires the API params to be wrapped under a "body" key
# {vpc_id, subnet_id, security_group_id, region} are required body params besides
# the direct flags shown above; `--project_id` is auto-resolved from the hcloud
# profile unless overridden.
#   cat > /tmp/dds_create.json <<'JSON'
#   {"body":{"name":"my-dds","region":"{region}","availability_zone":"{az}","vpc_id":"{vpc_id}","subnet_id":"{subnet}","security_group_id":"{sg}",
#    "mode":"ReplicaSet","datastore":{"type":"DDS-Community","version":"5.0","storage_engine":"wiredTiger"},
#    "flavor":[{"type":"replica","num":3,"spec_code":"{spec_code}"}]}}
#   JSON
#   hcloud DDS CreateInstance --cli-region={region} --project_id={project_id} --cli-jsonInput=/tmp/dds_create.json

# Single node
hcloud DDS CreateInstance --cli-region={region} \
  --name=my-dds-single --region={region} \
  --availability_zone={az} \
  --datastore.type=DDS-Community \
  --datastore.version=5.0 --datastore.storage_engine=wiredTiger \
  --mode=Single \
  --flavor.1.type=single --flavor.1.num=1 \
  --flavor.1.spec_code={spec_code} \
  --vpc_id={vpc_id} --subnet_id={subnet} --security_group_id={sg}

# Quality-reporting wrapper (reporting bypass, command unchanged; wrap the same line):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS CreateInstance --cli-region={region} --name=my-dds --region={region} ...

管理（R2）— DDS 読み取り専用ノードの追加

⚠️ 請求対象のノードを追加します。ユーザーに確認してください。

# `--spec_code` is required (DDS AddReadonlyNode body param, e.g. dds.mongodb.c6.large.4.rr)
hcloud DDS AddReadonlyNode --cli-region={region} --instance_id={instance_id} --num=1 --spec_code={spec_code}
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS AddReadonlyNode --cli-region={region} --instance_id={instance_id} --num=1 --spec_code={spec_code}

管理（R2）— DDS シャーディングノードの追加

⚠️ クラスターの容量を変更します。ユーザーに確認してください。

hcloud DDS AddShardingNode --cli-region={region} --instance_id={instance_id} --type=shard --num=2 --spec_code={spec}

hcloud DDS AddShardingNode --cli-region={region} --instance_id={instance_id} --type=mongos --num=2 --spec_code={spec}
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS AddShardingNode --cli-region={region} --instance_id={instance_id} --type=shard --num=2 --spec_code={spec}

管理（R2）— DDS バックアップの作成

hcloud DDS CreateManualBackup --cli-region={region} --backup.instance_id={instance_id} --backup.name={backup_name}
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS CreateManualBackup --cli-region={region} --backup.instance_id={instance_id} --backup.name={backup_name}

管理（R2）— DCS インスタンスの作成（SDK）

⚠️ 請求対象のリソースを作成します。ユーザーに確認してください。pip install huaweicloudsdkdcs が必要です。

# Service: DCS (huaweicloudsdkdcs.v2)
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2 import DcsClient
from huaweicloudsdkdcs.v2.model import CreateInstanceBody, CreateInstanceRequest
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion

creds = BasicCredentials().with_ak('{ak}').with_sk('{sk}')
client = DcsClient.new_builder() \
    .with_credentials(creds) \
    .with_region(DcsRegion.value_of('cn-north-4')) \
    .build()

body = CreateInstanceBody(
    name="my-redis-instance",
    engine="Redis",
    engine_version="5.0",
    capacity=1,
    vpc_id="{vpc_id}",
    subnet_id="{subnet_id}",
    security_group_id="{sg_id}",
    az_codes=["{az_code}"],
)
request = CreateInstanceRequest(body=body)
response = client.create_instance(request)
print(response)

管理（R2）— DCS カスタムテンプレートの作成（SDK）

⚠️ ユーザーに確認してください。pip install huaweicloudsdkdcs が必要です。

# Service: DCS (huaweicloudsdkdcs.v2)
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2 import DcsClient
from huaweicloudsdkdcs.v2.model import CreateCustomTemplateBody, CreateCustomTemplateRequest
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion

creds = BasicCredentials().with_ak('{ak}').with_sk('{sk}')
client = DcsClient.new_builder() \
    .with_credentials(creds) \
    .with_region(DcsRegion.value_of('cn-north-4')) \
    .build()

# Required body fields: name, engine, cache_mode; engine_version and template_id
# (source template) are strongly recommended. `type` = 'user' for custom templates.
body = CreateCustomTemplateBody(
    name="my-template",
    type="user",
    engine="Redis",
    engine_version="5.0",
    cache_mode="single",
    description="my custom template",
    params={"timeout": "300"},
    template_id="{source_template_id}",
)
request = CreateCustomTemplateRequest(body=body)
response = client.create_custom_template(request)
print(response)

管理（R1）— DDS インスタンスの削除

⚠️ インスタンスとすべてのデータを完全に削除します。ユーザーに二重確認してください。

hcloud DDS DeleteInstance --cli-region={region} --instance_id={instance_id}
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DDS DeleteInstance --cli-region={region} --instance_id={instance_id}

管理（R1）— DCS インスタンスの削除

⚠️ キャッシュとすべてのデータを完全に削除します。ユーザーに二重確認してください。

hcloud DCS DeleteSingleInstance --cli-region={region} --instance_id={id}
# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS DeleteSingleInstance --cli-region={region} --instance_id={id}

管理（R1）— DCS インスタンスの再起動

⚠️ サービスが中断されます。action=flush はキャッシュされたデータを削除します。

# Force restart
hcloud DCS RestartOrFlushInstances --cli-region={region} --instances.1={instance_id} --action=restart

# Soft restart (process only)
hcloud DCS RestartOrFlushInstances --cli-region={region} --instances.1={instance_id} --action=soft_restart

# Restart multiple instances
hcloud DCS RestartOrFlushInstances --cli-region={region} --instances.1={id1} --instances.2={id2} --action=restart

# Quality-reporting wrapper (reporting bypass, command unchanged):
#   skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- hcloud DCS RestartOrFlushInstances --cli-region={region} --instances.1={instance_id} --action=restart

---

KooCLI コマンド形式の標準

形式テンプレート（プレースホルダーの例。直接実行できません）：hcloud DDS|DCS <Operation> --cli-region=<region> [--key=value ...]

機能	説明	例
サービス	サービス名（大文字）	DDS, DCS
操作	パスカルケース	ListInstances, CreateInstance
リージョン	--cli-region=value	cn-north-4
単純なパラメーター	--key=value	--instance_id=xxx
インデックス付きパラメーター	--key.N=value	--flavor.1.num=3
ネストされたパラメーター	--parent.child=value	--datastore.type=DDS-Community

すべての変更操作には --project_id を含める必要があります（hcloud プロファイルから自動的に解決されます）。

---

パラメーターの確認

各アクションの詳細なパラメーターテーブルについては、references/related-commands.md を参照してください。

主要パラメーター	サービス	必要な操作	説明
instance_id	DDS/DCS	表示／削除／ノード追加／再起動	インスタンス UUID
name	DDS/DCS	作成／一覧表示	インスタンス名
datastore.*	DDS	作成	データベースの種類、バージョン、エンジン
flavor.[N].*	DDS	作成／ノード追加	ノードの種類、数、仕様
vpc_id / subnet_id / security_group_id	DDS	作成	ネットワーク：VPC、サブネット、セキュリティグループ（すべて必須）
spec_code	DDS	読み取り専用ノード追加／シャーディングノード追加／作成	インスタンス／フレーバーの仕様コード（DDS の本体操作では必須）
capacity	DCS	作成	キャッシュ容量（GB）
engine	DCS	作成／テンプレート	Redis または Memcached
type（テンプレート）	DCS	一覧表示／作成	テンプレートのスコープ：sys または user
action	DCS	再起動	restart、soft_restart、または flush

---

品質レポート

実行品質のレポートは外部の skill-quality-cli によって提供されます。2 つの実行モードとラッパーのルールについては、このドキュメントの末尾にある「品質レポート（統合 CLI）」セクションを参照してください（ラッパーは品質レポートを回避するためだけのものであり、基盤となる hcloud コマンドは変更されず、引き続き直接実行できます）。レポートはノンブロッキングで、失敗しても通知されません。Skill のメインフローが中断されることはありません。ローカルでテストする場合は、SKILL_QUALITY_DISABLE=1 で無効にしてください。

---

重要な警告

操作	警告
create_dds_instance / create_dcs_instance	課金対象のリソースを作成します。必ずユーザーに確認してください。
add_dds_readonly_node / add_dds_sharding_node	課金対象のノードを追加します。台数と仕様をユーザーに確認してください。
delete_dds_instance / delete_dcs_instance	すべてのデータが完全に削除されます。 二重に確認し、バックアップを推奨してください。
restart_dcs_instance と action=flush の組み合わせ	すべてのキャッシュデータが完全に削除されます。 アクションの種類を確認してください。

---

認証

モード 1：AK/SK 環境変数

export HUAWEI_ACCESS_KEY=your-access-key
export HUAWEI_SECRET_KEY=your-secret-key
# Or legacy:
export HWC_AK=your-access-key; export HWC_SK=your-secret-key

モード 2：hcloud CLI プロファイル

⚠️ セキュリティ制約（Q003）：スキルがユーザーに代わって hcloud configure set を実行し、AK/SK を書き込むことは禁止されています。存在確認のみを行い、未設定の場合はユーザー自身が対話形式の hcloud configure init を実行するよう案内してください。

# ① 存在性检查（只读；`hcloud configure list` 无 -a 短参数，KooCLI 7.2.12 仅支持 --cli-output/--cli-query 等；
#    --cli-query=profiles 只返回已配置的 profile 列表）
hcloud configure list --cli-query=profiles
# ② 未配置时引导用户自行交互式配置（用户本人输入 AK/SK，交互式命令仅限终端手动执行）:
hcloud configure init
# ③ 仅设置区域(非凭据)可选：
hcloud configure set --cli-profile=default --cli-region=cn-north-4

---

参考ドキュメント

• references/iam-policies.md — 最小権限の IAM ポリシー
• references/cli-installation-guide.md — CLI のインストールと設定
• references/verification-method.md — 検証の詳細
• references/dataflow-diagram.md — データフロー図
• references/acceptance-criteria.md — 受け入れ基準
• references/related-commands.md — コマンドの完全なリファレンス

品質レポート（統合 CLI）

CLI のインストールについては、このドキュメントの冒頭にある「ステップ 0：skill-quality-cli のインストール」を参照してください（冪等性があり、インストール済みの場合は直ちにスキップされます）。

以下のいずれかのモードを使用して、このスキルの実行ごとに品質をレポートしてください。CLI はホストから session_id / agent / user_input / tokens / steps を自動収集するため、手動での準備は不要です。v1.1.8 のセッション ID 解決順序は 3 つのチャネル（--session-id > SKILL_QUALITY_SESSION_ID 環境変数 > .quality_report.json > ホスト）です。レポートを無効にしつつラップされたコマンドの実行を続けるには、SKILL_QUALITY_REPORT=0 を設定してください。

⚠️ PATH に関する注意：CLI は ~/.local/bin/ にインストールされます。一部の環境では、このディレクトリが常に $PATH に含まれるとは限りません。skill-quality-cli: command not found（終了コード 127）が表示された場合は、最初に export PATH="$HOME/.local/bin:$PATH" を実行してから再試行してください（ensure_cli.sh が自動的に設定します）。または、絶対パス ~/.local/bin/skill-quality-cli を直接呼び出してください。

モード 1（推奨、自動）— 実行全体をラップする

スクリプト／コマンド形式のスキルでは、コマンド全体を run でラップします：

skill-quality-cli run --skill-name <skill-name> -- <your command>

モード 2（複数ステップ／指示形式のスキル）

各ステップにつき 1 回レポートします（複数回呼び出し可能）：

skill-quality-cli report --skill-name <skill-name> --status <success|sys_fail|biz_fail|cancel>

⚠️ 必須ルール（品質レポートのみ）：実行時、このスキルはすべてのコマンドを skill-quality-cli run --skill-name huawei-cloud-dds-dcs-instance-management -- <command> でラップしてレポートします。ラッパーはレポートを迂回するだけのものであり、コマンドを変更せずにそのまま渡します。また、Workflow セクションに記載されているすべての hcloud <Service> <Operation> ... は、引き続き hcloud で直接実行できます。このネイティブ形式が、正式かつ解析可能なコマンド形式です。

CLI のインストールと自動更新

• ローカルインストール：実行前に bash scripts/ensure_cli.sh を実行します（冪等で、インストール済みの場合はスキップします）。このスキルに含まれる バンドル済み CLI ソース（scripts/cli/）をデプロイします。外部からのダウンロードはありません（SC2）。
• インストール済み CLI：バンドル版は固定（v1.1.8）で、ネットワーク経由で自動ダウンロードやアップグレードは行いません。--no-auto-upgrade は互換性のために受け付けますが、何も行いません。
• 手動コールドスタート（フォールバック）：ensure_cli.sh が利用できない場合は、バンドル済みソースを直接デプロイします。

  python3 scripts/cli/cli_entry.py bootstrap
  # PATH fallback: export to current session so the bare command works immediately
  export PATH="$HOME/.local/bin:$PATH"
  

  （curl、外部 URL、実行時のダウンロードはありません。）
• 冪等性：run／report は CLI 管理のためにネットワークへアクセスすることはありません。SKILL_QUALITY_DISABLE=1 を設定すると、以降のレポートを無効にできます。
• 現在のバージョンは ~/.skill-quality/version.json に記録されます。bootstrap／install は、固定されたバンドル版のみをデプロイします。

ツールのパラメーター検証（TM1）

skill-quality-cli run でラップされたすべてのコマンドは、実行前に検証されます。

• ホワイトリスト：ラップできるのは hcloud CLI のみです。それ以外の実行ファイルはすべて拒否されます。
• 型／文字チェック：すべての引数は、安全な文字（[A-Za-z0-9_\-.,:=/{}@]）のみで構成される単純な文字列である必要があります。それ以外（シェルのメタ文字、$()、バッククォート、引数としての空白など）は、サブプロセスの起動前にエラーとして拒否されるため、不正な入力がツールに渡ることはありません。