mcpField
H
huawei-cloud-computing-query

huawei-cloud-computing-query

github.com/huaweicloud云与 DevOps5917.2k 次安装2 天前更新
代码仓库

关于 huawei-cloud-computing-query

此技能通过本地 Python 脚本和 Huawei Cloud Python SDK，以只读方式查询华为云资源、规格及详情。适用于需要盘点现有资源或为自动化准备实际参数的运维人员；所有查询都依赖脚本指南和真实 API 结果。

主要功能

  1. 01查询资源列表与详情
  2. 02查询可用规格、镜像和云盘类型
  3. 03获取资源标识及依赖关系
  4. 04通过技能执行脚本
  5. 05只读操作，不创建或修改资源

适用场景

  1. 01盘点指定区域的现有云资源
  2. 02查找操作系统可用镜像和实例规格
  3. 03为自动化配置收集资源 ID 与网络信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-computing-query

安装后在 Claude Code 中输入/huawei-cloud-computing-query确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

requirements.txt
references/as/
guide.md
references/bms/
guide.md
references/ecs/
guide.md
references/ims/
guide.md
scripts/as/
_common.py
list_all_scaling_v2_policies.py
list_api_versions.py
list_group_scheduled_tasks.py
list_hook_instances.py
list_life_cycle_hooks.py
list_resource_instances.py
list_scaling_activity_logs.py
list_scaling_activity_v2_logs.py
list_scaling_configs.py
list_scaling_groups.py
list_scaling_instances.py
list_scaling_notifications.py
list_scaling_policies.py
list_scaling_policy_execute_logs.py
list_scaling_tag_infos_by_resource_id.py
list_scaling_tag_infos_by_tenant_id.py
list_scaling_v2_policies.py
list_warm_pool_instances_new.py
list_warm_pool_instances.py
show_api_version.py
show_life_cycle_hook.py
show_policy_and_instance_quota.py
show_resource_quota.py
show_scaling_config.py

详细介绍

Huawei Cloud 资源查询

⚠️ 执行方式（必读）：此技能通过本地 Python 脚本执行查询。禁止使用 hcloud、openstack 或其他 CLI 工具，也禁止直接调用 API。

  • 查询脚本位于技能目录下的 scripts/<service_category>/（例如 scripts/as/list_scaling_groups.py）
  • 所有脚本和环境检查脚本都在技能包内。必须使用 skill action=exec 执行这些脚本；不要在 shell 中直接运行
  • 有关具体脚本路径和参数，请参阅 references/<service>/guide.md
  • 不要尝试使用 hcloud、openstack、curl IAM 或其他 CLI/API 方法；此技能不依赖这些工具
  • 所有路径均相对于技能目录，即包含此 SKILL.md 的目录

概述

此技能是独立的只读查询技能，通过本地 Python 脚本调用 Huawei Cloud Python SDK，查询 Huawei Cloud 资源、可用规格和现有资源信息。

此技能适用于以下场景：

  1. 查询指定区域中可用的云资源规格
  2. 查询特定操作系统的可用镜像
  3. 查询云硬盘类型和现有云硬盘信息
  4. 查询现有资源及其关键属性
  5. 查询未通过 Terraform 或其他 IaC 工具创建的资源
  6. 为自动化配置、资源验证或环境清单准备真实参数
  7. 获取可重复使用的信息，例如资源 ID、名称、规格、镜像、网络和云硬盘

此技能不处理以下事项：

  1. 创建资源
  2. 修改资源
  3. 删除资源
  4. 猜测或捏造未查询到的信息

能力范围

此技能通过 scripts 目录中的分类脚本提供查询能力，并通过 references 目录中的分类指南提供使用说明。 此技能提供的能力包括：

  1. 查询资源列表
  2. 查询单个资源的详情
  3. 查询可用规格、镜像和云硬盘类型等选项信息
  4. 查询现有资源的关键标识符和依赖关系

使用原则

重要提示：在此技能中执行的脚本路径均相对于技能目录，即包含此 SKILL.md 的目录。

  1. 此技能仅执行查询；不执行任何写入操作
  2. 优先使用用户明确指定的信息，例如区域、项目、AZ、资源名称和资源 ID
  3. 查询结果必须基于实际 API 响应；不要根据经验进行推测
  4. 返回结果应保留关键字段，以便后续复用
  5. 当结果集较大时，优先使用区域、名称、id、状态和标签等条件缩小范围
  6. 如果当前资源类型没有对应的脚本或指南，应明确说明不支持；不要返回不可靠的结果
  7. 如果用户未提供必要的范围信息，且环境中没有默认值，应在执行查询前确认相关信息
  8. 直接按照 guide.md 执行；不要读取 scripts 目录中的脚本内容
  9. 输出较大时，请缓存输出
  10. 执行每个脚本前，必须先执行 -h 查看用法
  11. 不要捏造脚本名称；应按照 guide.md 中的脚本名称执行。如果脚本名称未列在 guide.md 中，则表示不支持

前提条件

使用前，必须运行环境检查脚本，一步完成环境验证和依赖安装：

  • Linux / macOS：skill action=exec: bash skill://scripts/check_env.sh
  • Windows：skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1

Windows 注意事项：不要使用 && 拼接命令（PowerShell 5.x 不支持）；如果需要先切换目录，请使用分号

脚本将按顺序检查：Python >= 3.6 → 安装依赖项 → 验证 SDK → 验证凭证 → 验证服务可用性。如果环境检查失败，请先解决问题，再继续运行其他脚本。

环境变量：

变量必需说明
HW_ACCESS_KEY是Huawei Cloud AK
HW_SECRET_KEY是Huawei Cloud SK
HW_REGION_NAME否默认值为 cn-north-4
HW_PROJECT_ID否项目 ID（如果未设置，将通过 IAM API 自动获取）
HW_SECURITY_TOKEN否临时 AK/SK 所需

请勿输出上述环境变量的值。 对于需要其他参数（可用区、企业项目等）的资源脚本，请参阅相应的 guide.md。

执行流程

调用此技能时，必须按照以下步骤操作；不要等待用户再次提示：

步骤 1：准备环境

运行环境检查脚本，确保依赖项已安装且凭证已配置：

  • Linux / macOS：skill action=exec: bash skill://scripts/check_env.sh
  • Windows：skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1

如果环境检查失败，请按照提示解决问题，并重新执行，直到检查通过。

步骤 2：识别并执行查询脚本
  1. 根据用户查询意图，阅读 references/<service>/guide.md，确定要执行的脚本路径和参数
  2. 先执行 -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
  3. 根据用户需求组装参数并执行脚本：
    • Linux / macOS：skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py <parameters>
    • Windows：skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py <parameters>
  4. 格式化结果并返回给用户

重要事项：

  • 所有脚本和环境检查脚本均位于技能包中。必须使用 skill action=exec 执行；请勿直接在 shell 中运行
  • venv 由 check_env 脚本自动创建。在 Linux/macOS 上，Python 位于 .venv/bin/python3；在 Windows 上，位于 .venv/Scripts/python3.exe
  • 请勿直接使用 python3 执行脚本
  • 请勿读取 scripts 目录中的脚本源代码；请按照 guide.md 中的说明执行
  • 如果输出内容较多，请缓存结果
  • --project_id 参数为可选项；如果未提供，将根据区域通过 IAM API 自动获取

目录结构

目录约定如下（所有路径均相对于技能目录）：

  1. scripts/<resource_category>/ 包含对应资源的 Python 查询脚本。无需读取脚本内容；请按照 guide.md 中的用法说明执行脚本
  2. references/<resource_category>/guide.md 包含对应资源的使用指南
  3. 每个脚本负责一项明确的查询操作
  4. 每个资源类别至少包含一个 guide.md，用于说明脚本功能、参数和用法

参数确认

在执行查询脚本前，请确认以下参数：

参数必填说明
region是华为云区域，例如 cn-north-4
--project_id否项目 ID；如果未提供，将自动获取
--availability_zone否可用区；部分资源查询需要此参数

有关脚本专属参数，请参阅 references/<service>/guide.md。

输出格式

查询结果以 JSON 格式输出，包含以下常见字段：

  • total：匹配资源的总数
  • items：资源列表，每个资源包含 id、name 和 status 等关键字段
  • 具体字段因资源类型而异；详情请参阅各自的 guide.md 文件

验证方法

  1. 执行环境检查脚本，确认依赖项和凭证可用
  2. 使用 -h 参数查看脚本用法，并确认参数正确
  3. 查询已知资源，并与控制台数据对比以验证结果准确性
  4. 检查返回的 total 数量是否合理

最佳实践

  1. 先缩小查询范围（指定 region、可用区等），避免返回过多数据
  2. 使用 --help 查看脚本支持的完整参数列表
  3. 查询结果较多时，将结果缓存在本地，以避免重复请求
  4. 需要查询多种资源信息时，按依赖顺序查询（例如先查询 VPC，再查询子网）
  5. 脚本执行失败时，先检查环境变量和网络连接

参考文档

  • 各服务的查询脚本使用指南：references/<service>/guide.md

注意事项

  1. 此技能仅提供只读查询能力；不会执行任何写操作
  2. 请勿输出 HW_ACCESS_KEY 和 HW_SECRET_KEY 等环境变量的值
  3. 所有脚本都必须通过 skill action=exec 执行；请勿直接在 shell 中运行
  4. 请勿编造脚本名称；严格按照 guide.md 中的名称执行
  5. 查询前必须运行环境检查脚本
  6. 使用临时 AK/SK 时，需要设置 HW_SECURITY_TOKEN

评论

支持 Markdown