用途
华为云 IAM 查询技能（huawei-cloud-iam-query）是一个独立的只读查询技能，使用本地 Python 脚本调用华为云 Python SDK，用于查询华为云资源、可用规格以及现有资源信息。它适用于查询给定区域的可用云资源规格、查询某操作系统的可用镜像、查询云硬盘类型与现有云硬盘信息、查询现有资源及其关键属性、查询并非通过 Terraform 或其他 IaC 工具创建的资源，以及为自动化配置、资源校验或环境盘点准备真实参数，获取资源 ID、名称、规格、镜像、网络、磁盘等可复用信息。
该技能不处理创建资源、修改资源、删除资源，也不允许猜测或编造未经查询的信息。
主要能力
技能通过 scripts 目录下按类别划分的脚本提供查询能力，并通过 references 目录下按类别划分的指南提供使用说明。具体包括：查询资源列表、查询单个资源详情、查询可用规格/镜像/磁盘类型等选型信息、查询现有资源的关键标识与依赖关系。
使用方式
前置条件：使用前必须运行环境检查脚本，一次性完成环境校验与依赖安装。
Linux / macOS：skill action=exec: bash skill://scripts/check_env.sh
Windows：skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1
脚本会依次检查 Python >= 3.6、安装依赖、校验 SDK、校验凭据、校验服务可用性。若环境检查失败，须先修复问题再继续执行其他脚本。Windows 注意：不要使用 && 链接命令（PowerShell 5.x 不支持），如需先切换目录可使用分号。
环境变量：HW_ACCESS_KEY（必填，华为云 AK）、HW_SECRET_KEY（必填，华为云 SK）、HW_REGION_NAME（可选，默认 cn-north-4）、HW_PROJECT_ID（可选，未设置时通过 IAM API 自动获取）、HW_SECURITY_TOKEN（可选，使用临时 AK/SK 时必填）。不要输出上述环境变量的值。
执行流程：第一步运行环境检查脚本，确保依赖已安装且凭据已配置；第二步根据用户查询意图，阅读 references/<service>/guide.md 确定脚本路径与参数，先执行 -h 查看用法，再组装参数执行脚本，最后格式化结果返回用户。
Linux / macOS 示例：skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py -h
Windows 示例：skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py -h
说明：所有脚本与环境检查脚本都在技能包内，必须使用 skill action=exec 执行，不要在 shell 中直接运行；venv 由 check_env 脚本自动创建；不要直接用 python3 执行脚本；不要读取 scripts 目录下的脚本源码，只需按 guide.md 的说明执行。
目录结构与参数
scripts/<resource_category>/ 包含对应资源的 Python 查询脚本；references/<resource_category>/guide.md 包含对应资源的使用指南。每个脚本只负责一个清晰、单一的查询动作；每个资源类别至少维护一个 guide.md。
执行查询脚本前需确认参数：region（必填，华为云区域，如 cn-north-4）、--project_id（可选，未提供时自动获取）、--availability_zone（可选，部分资源查询需要）。脚本专属参数见 references/<service>/guide.md。
输出格式与验证
查询结果以 JSON 格式输出，包含常见字段：total（匹配资源总数）、items（资源列表，每项包含 id、name、status 等关键字段）。具体字段因资源类型而异，详见各 guide.md。
验证方式：运行环境检查脚本确认依赖与凭据可用；使用 -h 参数查看脚本用法并确认参数正确；对已知资源执行查询并与控制台数据比对以验证结果准确性；检查返回的 total 计数是否合理。
适用场景与最佳实践
适用于资源盘点、可用规格与镜像查询、现有资源属性与依赖关系查询，以及为自动化配置准备真实参数。最佳实践包括：先缩小查询范围（指定区域、可用区等）以避免返回过多数据；使用 --help 查看脚本支持的完整参数列表；将较大的查询结果缓存到本地以避免重复请求；查询多个资源时按依赖顺序进行（例如先查 VPC，再查子网）；脚本执行失败时先检查环境变量与网络连通性。
限制与注意事项
该技能仅提供只读查询能力，不执行任何写操作。不要输出 HW_ACCESS_KEY、HW_SECRET_KEY 等环境变量的值。所有脚本必须通过 skill action=exec 执行，不要在 shell 中直接运行。不要猜测脚本名称，严格按 guide.md 中的名称执行。查询前必须先运行环境检查脚本。使用临时 AK/SK 时必须设置 HW_SECURITY_TOKEN。若当前资源类型没有对应脚本或指南，应明确说明不支持，不要返回不可靠结果。若用户未提供必要的范围信息且环境无默认值，应先确认缺失信息再执行查询。